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This publication describes the logic of 
IPL (initial program loader) and NIP (nuc- 
leus initialization program) for OS/VS2. 
The information is intended for use Ly per- 
sonnel responsible for program maintenance. 
IPL loads the nucleus designated by the 
user and prepares the system for initiali- 
zation. NIP initializes the nucleus and 
the remainder of real storage in prepara- 
tion for system execution. 


ORGANIZATION OF THIS BOOK 


This publication contains six sections. 


"Section 1. Introduction" provides an 
overview of the functions performed by IPL/ 
NIP and contains background information on 
linkage between modules and sukroutines. 
The section also describes real storage 
areas, data sets used Ly IPL/NIP, format- 
ting page data sets, and the quickstart/ 
coldstart process. 


"Section 2. Method of Operation" 
describes in more detail the functions per- 
formed by the IPL/NIP modules. Method-of- 
operation diagrams show the input, process- 
ing, and output of modules and subroutines. 


"Section 3. Program Organization" 
describes the structure of the IPL/NIP 
modules. It also contains flowcharts of 
complex areas of code. 
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"Section 4. Directory™ contains a dire- 
ctory of entry points, showing module 
names, function, and diagram number. 


"Section 5. Data Areas" contains 
descriptions of control blocks and data 
areas used by IPI/NIP. 


"Section 6. LCiagnostic Aids" contains 
messages and wait state codes issued ry the 
IPL/NIF modules. It also contains a 
register usage table and a module data 
field cross-reference table. 


PREREQUISITE READING 


Readers of this publication should Le 
familiar with the following OS/VS 
publications: 


OS/VS2_ Supervisor Logic, SY27-7244. 


OS/VS_ Supervisor Services and Macro 
Instructions, GC27-6979. 


Supplementary Reading 


Information in the following publica- 
tions may be helpful in understanding IPL 
and NIP: 


VS2 System Messages, GC28-1002. 
OS/VS_ System Codes, GC28-1003. 

VS2 Operator's Reterence, GC38-0210. 
VS2 System Data Areas, SY28-0606. 
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IPL (initial program loader) and NIP 
(nucleus initialization progran) initialize 
the VS2 system by loading the supervisor 
and preparing the system for execution. 
Because the functions of IPL and NIP are 
related, and because NIP execution immedi- 
ately follows IPL execution, IPL and NIP 
are treated in this publication as one 
component. 


Diagrams 0.1 and 0.2 show the wain func- 
tions performed by IPL and NIP. 


THE INITIAL PROGRAM LOADER 


IPL is brought into real storage when 
the operator presses the LOAD button. (See 
"Section 2: Method of Operation" for a 
description of how IEAIPLOO is loaded.) 


IPL loads the resident nucleus that was 
created during system generation (either a 
nucleus designated by the uSer or one 
assigned by the system). IPL then limits 
real storage to the size specified by the 
user (if defaulted, it is to the actual 
Size of real storage), and clears real 
Storage up to the effective size to 0's. 
IEAIPLOO initializes system tables and gen- 
eral registers for use during NIP 
execution. 


After IPL has been executed, control is 
passed to the first NIP module, IEAVNIPO, 
which was loaded as part of the resident 
nucleus. 


THE NUCLEUS INITIALIZATION PROGRAM 


NIP initializes real storage, provides 
access to the various system data sets, and 
provides access to virtual storage by 
initializing the appropriate paging tables. 
Because NIP performs its functions sequen- 
tially, and because each function is per- 
formed primarily by one module (often with 
assistance from a service module), NIP 
execution is described on a module basis. 


The modules IEAVNIPM and IEAVNP0? each 
performs special sequential processing, but 
those modules also contain subroutines that 
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perform common functions for one or more 
other NIF modules. IEAVNPA4 and IFAVNPAS 
function solely as service routines. 


The NIP modules perform the following 
functions: 


e Define the initial part of the NVT (NIP 
vector table), define the SQA (system 
queue area), define the nucleus buffer, 
define NIP's dynamic area, provide 
access to the SYS1.NUCLEUS data Set, 
and place the CPU in EC (extended con- 
trol) mode with translation enabled 
(IEAVNIPO). 


e Control the sequence of executicn for 
NIP modules and handle requests for 
execution of nonresident SVC routines 
(IEAVNIPWM). 


e Initialize system consoles (IEAVNPO1). 


e Initialize the system device configura- 
tion, the SVC library (SYS1.SVCLIB), 
and the system log data set (SYS1. 
LOGREC) (IEAVNPO2). 


e Process parameters specified by the 
system programmer and the operator 
(ITEAVNPO3). 


e Initialize paging control blocks and 
data areas for the paging supervisor 
(LEAVNPO4 and IEAVNPA4). 


e Define link pack area modules for 
guickstart or coldstart processing 
(LEAVNPO5 and IEAVNPAS). 


e Initialize the reliability and servi- 
ceakility (RAS) features (IEAVNPO6). 


e Define the hardcopy console, fageakle 
CCMs (display control modules), and the 
paging algorithm limit values 
(IEAVNPO7). 


e Define the nonpageable dynamic area, 
quickcell tables, available stcrage, 
the master scheduler's region, and the 
dispatcher's APG (authorized friority 
group) takle and time-slice queues 
(LEAVNIPX). 
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Diagram 0.1: IPL/NIP processing 
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Diagram 1.2 
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Diagram 0.2: NIP processing under control of IEAVNIPM 
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Diagram 0-2: NIP processing under control of IEAVNIPM (Part 2 of 3) 
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Diagram 0-2: NIP processing under control of IEAVNIPM (Part 3 of 3) 
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LINKAGE TO SERVICE SUBROUTINES 


In addition to mainline processing, the 
NIP modules IEAVNIPM, IEAVNP02, and IEAVN- 
PA4Y contain subroutines that perform common 
functions for other NIP modules. The IEAV- 
NIPM and ITEAVNPO2 subroutines are executed 
in response to the NIP macro instruction 
IEAPMNIP. When an IEAVNIPM subroutine is 
requested, the macro expands to contain the 
address of the required subroutine and a 
BAL instruction to that address. When the 
IEAPMNIP macro instruction specifies a sub- 
routine within IEAVNP02, the macro expan- 
Sion contains a BAL to the NIPLOAD subrou- 
tine within IEAVNIPM to load IEAVNPO2, a 
BAL to the IEAVNP0O2 subroutine entry point, 
and an SVC 9 (DELETE) instruction. 


IEAVNPA4Y is initially brought into 
storage when the IEAPMNIP macro instruction 
is issued by IEAVNPO4 (the expansion con- 
tains the BAL to NIPLOAD to load IEAVNPA4 
and a BAL to the entry point). Subsequent 
entries from IEAVNPO4Y, IEAVNP0O5, and IEAVN- 
PA5 are by a BALR instruction which con- 
tains the entry address found in the NIP 
vector table. The particular subroutine 
required is indicated by bit settings in 
the parameter list passed in register 1. 
The last linkage from IEAVNP05 to an IEAVN- 
PA4Y subroutine is also by the IEAPMNIP 
Macro. This expansion contains an SVC 9 
(DELETE) instruction to logically remove 
IEAVNPAY from storage. 


PAGE DATA SET FORMATTING AND THE 
QUICKSTART/COLDSTART PROCESS 


One of the required NIP functions is to 
initialize the page data sets. Each paging 
device specified during system generation 
or by the operator using the PAGE parameter 
is considered a page data set and is 
referred to as such in the following 
discussion. 


For each unformatted page data set, only 
the “home address“ and record 0 contents of 
any track are known, and the remainder of 
the track must be formatted into records of 
specified size and characteristics. NIP 
formats each page data set by executing a 
channel program which writes the count, 
key, and data for the specified number of 
records. The channel program varies 
depending on the type of device containing 
the data set being formatted and the PAGE 
parameter specifications. 


For each data set that is formatted, NIP 
Maintains a record, called a quickstart 
record, or NIPQSR1. Each NIPQSR1 record 
contains the number of tracks formatted, 
the number of pages in the data set that 
are available (a page is unavailable if the 
track is defective or if it will be allo- 


cated to NIPCSR1), and a “bit map" that 
indicates which pages are available. Each 
NIPQSR1 record is written to record 1 of 
the first track of the page data set. 


The NIPQSR1i records serve an important 
function when the operator must restart the 
system by performing another IPL. During 
NIP processing for the restart, NIP checks 
the NIPQSR1 record for each page data set 
to determine whether the data set must be 
reformatted. NIP performs the I/O opera- 
tions required to reformat a page data set 
only when: 


® The NIPOSR1 record cannot be read 
(either the data set was not formatted 
or the NIPQSR1 record is defective). 


e As part of the system restart, the 
operator has entered new specifications 
for the data set, and the data set is 
too small to meet the requirements. 


e The operator has entered new specifica- 
tions for the data set, and a factor 
other than size requires the data set 
to be reformatted. 


Because the pages for the LPA (link pack 
area) remain static during execution, two 
additional quickstart records are created 
to provide additional information akout the 
LPA page data set. The additional records 
are NIPQSR2 and NIPQSR3. 


NIPQSR2 contains the virtual address of 
the LPA directory, the highest virtual 
address assigned to the LPA, and a bit map 
of available pages in the data set. 

NIPQSR3 contains a slot/group map of the 
sequential LPA address space. There may be 
one to three NIPQSR3 records for the LPA 
page data set. 


Quickstart and Coldstart Process: During 
the first IPL for a system, NIP reads the 


LPA modules from the SYS1.LPALIB data set 
and writes (loads) them into the LPA page 
data set. At the same time, NIP builds the 
NIPQSR2 and NIPQSR3 records and writes them 
to the data set. 


Normally, the LPA modules are not 
reloaded during a subsequent IPL. The only 
time they are reloaded is when: 


e The NIPQSR1 record for the LPA page 
data set cannot be read, forcing NIP to 
reformat the data set and reload the 
modules because it has no assurance 
that the data set has previously Leen 
formatted. 


e The operator specifies the CLPA para- 
meter, indicating that the contents of 
the LPA are to be modified during the 
restart. 
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e The PAGE parameter specifies that 
another data set is to contain the LPA. 


e The SQA system parameter is so speci- 
fied that SQA infringes on the LPA vir- 
tual address space, and the operator 
accepts this condition. 


The initialization’ process in which the 
LPA modules must be loaded into the data 
set is called the coldstart process. 


The process of reinitializing the system 
without reloading the LPA modules (that is, 
by using the LPA page data set created dur- 
ing a previous initialization) is called 
the quickstart process. This name refers 
to the time saved by not having to reload 
the LPA modules. 


DATA SETS USED BY IPL/NIP 


Because all data used by IPL/NIP ori- 
ginates in or will reside in system data 
sets, it is important to be familiar with 
the following list of these data sets and 
brief descriptions of their contents. 


e SYS1.NUCLEUS -- Contains the resident 
nucleus and all NIP 
modules. 

e SYS1.LOGREC <-- Used for recording I/0 


and hardware errors. 


e SYS1.LINKLIB 


- Contains user and sys- 
tem programs. 

e SYS1.SVCLIB -- Contains the type 3 and 

4 SVC routines used 

“during NIP processing 

and RMS routines. 


Contains all of the 
modules for the link 
pack area. 


e SYS1.LPALIB 


e SYS1. PAGE -~- Contains the auxiliary 
Space for system 
paging. 

e SYS1.DUMP -- Used for dumping the 


contents of storage. 


e SYS1.PARMLIB -- Contains the system 
parameters referred to 
With the SYSP parameter 
from the operator con- 
sole and the LINKLIB 
concatenation member, 
LNKLST0O0, and the MLPA, 
FIX, and BLDL module 
name lists. 
e SYS1.DSSVM -~- Contains the dynamic 
support system virtual 
storage. 


REAL STORAGE AREAS DURING NIP EXECUTION 


During NIP execution, real storage is 
logically divided into several areas. 
Because these areas are continually 
referred to in the method-of-operation dia- 
grams and the text in Section 2, brief 
descriptions of these areas and their con- 
tents are provided. The following are 
descriptions of the real storage areas in 
ascending order (from the lowest address to 
the highest): 


e Nucleus: This is the lowest area of 
real storage and contains the modules, 
system control blocks, and system data 
areas that remain in real storage dur- 
ing execution. Because they remain in 
real storage, no paging is required. 
The nucleus is created during system 
generation, and some of its control 
blocks are initialized during IPI/NIP 
execution. 


e Nucleus Buffer: This area occupies the 
Space immediately above the nucleus. 
It contains additional control Elocks 
and data areas created by NIP. The 
nucleus buffer becomes a logical and 
physical extension of the nucleus. Two 
fields in the NIP vector table 
(NVTNUCND and NVTBUFND) point to the 
next area in the nucleus buffer into 
which additional data can be placed, 
and the upper limit of the nucleus 
buffer, respectively. 


e NIP*'s Dynamic Area: This area is imme- 
diately above the nucleus buffer and 
contains the NIP modules that are 
required for execution of NIP. The 
modules are loaded into the highest 
availakle area within the dynamic area. 


e Initial Paging Area: This area is 
immediately above NIP's dynamic area 
and is used for paging functions during 
NIP execution. 


e System Queue Area: This area is in the 
highest real storage space. It con- 
tains the control blocks and queue ele- 
ments required for virtual storage 
supervision and the segment and page 
tables required for paging supervision. 


DATA AREAS AND CONTROL BLOCKS USEC BY NIP 


The following data areas and control 
blocks are used only during NIP execution. 
They are either overlaid during system 
execution (for example, the NVT and the 
PARMAREA) or are not used (for example, the 
quickstart records). 
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NIP Vector Table (NVT) 


The NVT contains pointers and flags that 
are used only by NIP. Its relationship to 
NIP execution is similar to that of the CVT 
to system execution. The NVT base is 
created by IEAVNIPO and is moved into and 
further initialized by IEAVNIPM. It is 
used by all NIP modules. 


Quickstart Records 


There are three types of quickstart 
records. The first type, NIPQSR1, is 
created and written to a page data set when 
the data set is formatted. The other two 
types of records, NIPQSR2 and NIPQSR3, are 


created and written only for page data sets 
containing link pack area modules. The 
contents and use of the quickstart records 
are more fully described under "Page Data 
Set Initialiization and the Quickstart/ 
Coldstart Process" in this section. 


PARMAREA 


The PARMAREA is created by IEAVNPO3 and 
initialized with the system parameters spe- 
cified by the system programmer or by the 
operator. It also contains a table of 
addresses (PARMTAB) that point to the sys- 
tem parameters and a data area required for 
reading the system parameters from the 
SYS1.PARMLIB. 








This section uses text and diagrams to 
describe the functions performed by IPL/ 
NIP. The method-of-operation diagrams are 
the primary vehicle for describing the IPL/ 
NIP functions. Notice that the diagrams 
emphasize the sequence of functions rather 
than the detailed step-by-step logic found 
in flowcharts. For information on how to 
use the diagrams, please read the next sub- 
section, "“USing Method-of-Operation 
Diagrams." 


The text in this section supplements the 
diagrams. The text descrikes Ltriefly the 
functions performed by each module and the 
major subroutines within each module. 
Detailed descriptions of complex processing 
are given in “Section 3: Progran 
Organization." 


The initial program loader is the fourth 
record on cylinder 0, track 0 of the system 
residence volume. The nucleus initializa- 
tion program modules are members of the 
SYS1.NUCLEUS data set. IPL loads the resi- 
dent nucleus and the first NIP module, IEA- 
VNIPO, which was previously link-edited 
with the resident nucleus to form the 
IEANUCOx member of the SYS1.NUCLEUS data 
set. IEAVNIPO in turn causes the loading 
of the NIP control module, IEAVNIPM, which 
sequentially loads and deletes IEAVNPO1, 
IEAVNP02, IEAVNP03, IEAVNPOY, IEAVNPOS, 
IEAVNP06, and IEAVNP0O7. A subroutine 
within IEAVNIPM also causes the loading and 
deletion of IEAVNP02 when subroutines 
within it are required by other NIP 
modules. 


Other special loading and deletion 
operations are: 


e IEAVNPA4Y is loaded by IEAVNIPM for 
IEAVNPO4 and deleted by IEAVNPO5. 


e IEAVNPAS is loaded by IEAVNIPM for 
IEAVNPO5 and deleted by IEAVNPOS. 


e IEAVNIPX iS loaded by IEAVNIPM and is 
self deleted. 


The IPL and NIP modules are described in 
this section in the order in which they are 
normally executed. 


USING METHOD-OF-OPERATION DIAGRAMS 


Method-of-operation diagrams are pro- 
vided for all IPL/NIP modules and most of 
the subroutines within these modules. 
These diagrams describe the functions per- 
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formed by the modules and show the inrut 
and output associated with the functions. 


Where necessary, the froceSSing Sters in 
a method~of-operation diagram are further 
explained by “Notes on Processing." Each 
note amplifies a functional statement in 
the diagram and gives the label in the code 
that performs the function. Each note is 
related to the appropriate processing step 
ky the function number (the number adjacent 
to the step in the diagram). Where no note 
is given, it is presumed that the statement 
in the diagram and the comments in the code 
provide an adequate explanation of the 
function. The reference labels included in 
the "Notes on Processing" provide a means 
cf finding the point in the code at which 
each function is performed. 


To help the reader understand and use 
these diagrams, this section contains a 
sample diagram, an explanation of diagran- 
wing conventions (Figure 1), and text that 
explains the sample diagran. 


The sample diagram describes the func- 
tions performed Ly module IFAVNzzz. The 
first five characters in all NIP module 
names are “IEAVN". The characters "zzz" 
represent the unique suffix in each module 
name. 


The wide, shaded arrow indicates entry 
to a module, exits from a module, or major 
paths of execution within or between 
modules. Entry to the module in the sample 
diagram is from IEAVNxxx, Step y. 


MEANING OF ARROWS USED IN METHOD-OF-OPERATION DIAGRAMS 


> Primary Entry/Exit Path -- Shows the path 
followed to accomplish the principle function 
————_—_—_—— 


of the body of code described by the diagram, 


Secondary Path -- Shows the path used by a 
processing step to accomplish a subordinate 
function. 


Pointer -= Shows that a field in one data area 
contains the address of another field or data 
area. 


Data Reference -- Shows that the contents of 
a data area are tested or read to determine 
the course of subsequent processing. 


| 


Data Modification == Indicates data 
modification (change to any field or 
register). 


Figure 1. Key to symbols in method-of- 


operation diagrams 
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Diagram X.X: IEAVNzzz 
Sample Diagram 


From Diagrom XX, 
Step Y 









Input Processing 
IEAVNzzz 


1. Perform Function 1 processing. 













2 


Perform Function 2 processing. 


3 > Perform Function 3 processing. Subroutine D 





A Determine whether . . . 





Register nn 


IEAVNyyy 
Diagram XX, Step Y 





Perform Function 4 processing. 





Set code. 


NIPSWAIT 
X"00" 







3f WOTQOeS 


uotTzezedo jo pourzNW 


TT 


Diagram X.X IEAVNzzz 


1. This note would explain in more 
detail the processing for function 
1. 


2. Control is passed to a subroutine 
that is not part of this module. 


3. Control is passed to a sukroutine 
that is part of this module. 


4. This note would amplify the deci- 
sion made. 


5. Exit is to IEAVNyyy. 


6. The system is put in a wait state 
with the code X‘00‘. 


{ 
| 


IEAVNZZz 


Processing Steps 1 and 2 refer to fields 
CVTaaaaa and NVTErErEb. Data areas used 
across the system are described fully in 
VS2 Data Areas. Data areas pertinent only 
to NIR are described in Section 5 of this 
manual. Referring to a field usually 
involves loading the contents of the field 
into a register for testing or addressing. 
A reference to a field does not include 
modification of the field. 


To perform functions 2 and 3, the module 
in the sample diagram requires the services 
of other routines. Module C is another 
module (it may be a NIP module) used to 
perform function 2. Linkage to another NIP 
module is achieved by issuing an internal 
NIP macro instruction, the expansion of 
which causes (1) the NIPLOAD subroutine in 
IEAVNIPM to be entered to load the module, 
(2) a BAL instruction to give control to 
the module, (3) the required input parame- 
ters to be expanded inline, and (4) a sub- 
sequent SVC instruction to delete the 
module. Function 3 requires the processing 
of Subroutine D which is within this 
module. Subroutines described in this 
Manner are entered by a BAL instruction and 
normally return control to the next sequen- 
tial instruction. Where modules and sub- 
routines are described by method-of- 
operation diagrams in this manual, the 
number of the diagram is given in the lower 
right-hand corner. 


In cases where secondary or suprortive 
processing is required, the narrower shaded 
arrows indicate the flow of processing. 


The fifth processing step uses the con- 
tents of register nn. The contents of 
other registers are not shown as input 
because they are not used by this module. 


The normal exit from this module is to 
module IEAVNqgqq. Where appropriate, the 
number of the step in the diagram to which 
exit is made is shown. 


The error processing that occurs in ent- 
ering a disabled wait state includes stor- 
ing a wait state code and branching to the 
NIPSWAIT subroutine in IEAVNIPM, which 
places the system in the disabled wait 
State. ” 


THE IPL RECORDS AND IEAIPLOO (DIAGRAM 1.0) 


The initial program loader is the pro- 
gram that initializes real storage and 
loads the specified control program nuc- 
leus. The nucleus is assembled during sys- 
tem generation and resides on the SYS1. 
NUCLEUS data set. The nucleus contains 
system control blocks, data areas, resident 
control program modules, and the first 
module of the nucleus initialization pro- 
gram that will be executed (IEAVNIPO). 
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High address 


Record 4 
IPL Text 


Record 2 


Record | 





Low address 


Figure 2. Location of IPL records in real 
storage 


IEAIPLOO gains control when the operator 
presses the LOAD button. The operator pre- 
pares for loading IEAIPLOO by mounting the 
system residence volume on a direct access 
device and setting the load unit address 
Switches to the unit address of that 
device. Pressing the LOAD button causes a 
system reset, turns on the LOAD light, 
turns off the MANUAL light, and initiates a 
read operation from the selected direct 
access device. 


When the read operation is started (see 
Figure 2), the selected input device starts 
transferring data. The first IPL record is 
read into real storage locations 0 through 
23. The doubleword read into locaticn 8 
(through 15) is a CCW (channel conmand 
word) that causes the loading of the second 
record into real storage at an address 
higher than the size of the third IPL reco- 
rd, so that the second record will not ce 
overlaid. The Transfer-in-Channel command 
at location 16 (in the first record) speci- 
fies the address of the second record. The 
second record is a chain of CCWs that cause 
the IPL control section (third record) to 
be read into real storage beginning at 
location 0. 


When the channel end is received (indi- 
cating that the last CCW in the second 
record has been executed), the unit address 
of the device is stored in bits 21-31 of 
the first word in storage. Bits 16-20 are 
set to 0, and bits 0-15 remain unchanged. 
The doukleword in storage location 0 is 
loaded as a new PSW, and normal orferation 
proceeds. The LOAD light then turns off. 
IEAIPLOO does these things: 


e Clears general and floating-point 
registers. 





(3 








e Clears real storage to the highest 
addressable location (the highest 
addressable location may be specified 
by the operator as a location lower 
than the highest actual address in real 
storage). 


e Sets all storage keys to 0. 


e Relocates unexecuted coding and data 
areas above the real storage area to be 
occupied by the resident nucleus and 
loads the nucleus specified by the 
operator (IEANUCOx) or the systemn- 
assigned nucleus IEFANUCO1 (see Figure 
3). 


e Transfers control to the first NIP 


module, IEAVNIPO, which is loaded as 
part of the resident nucleus. 


Processing Expected Program Checks 

At certain points during execution, 
IEAIPLOO expects program checks to occur. 
These are caused when IEAIPLOO clears real 
storage and sets the storage keys for 2K 
multiples of storage. IEAIPLOO uses loop 
processing to perform these functions. 
When the instructions in the loop address a 


<< ce ce ce ce es os a a ee 


Real Storage before IPL Relocation 


Figure 3. 


location greater than the size of real 
storage, a program check occurs. Antici- 
pating this action, IEAIPLOO sets the 
program-check new PSW to the address of the 
next sequential instruction beyond the par- 
ticular loop processing. When this proces- 
Sing is complete, the program-check new PSW 
is set to the address of the IEAIPLOO sub- 
routine that processes unexpected rfrogran 
checks. Unexpected program checks result 
in a system wait state with a code of X‘'19' 
keing placed in the address portion of the 
current PSW. 


Operator Interface During IPL 


IFAIPLOO provides two interfaces that 
allow the operator to limit the size of 
real storage (specify that the full size of 
real storage is not to be effective), and 
to specify a nucleus other than the system- 
assigned nucleus, IEANUCO1. To use these 
interfaces, the operator sets an address 
stop at location X‘'80° before pressing the 
LOAD button. When this address stop is 
reached (by the CPU processing the third 
IPL record), the operator selects an 
alternate nucleus by storing in location 


| x'os' the EBCDIC character to be aprended 


to IEANUCO. This suffix is used by 


Relocated IFAIPLOO from 
Label IEADATDS 


eee ee ee ee Se ee ee 


Real Storage after IPL Relocation and 
Loading cf Nucleus and IEAVNIPO 


Contents of real storage before and after IPL relocation 


Section 2: Method of Operation 13 


ITEAIPLOO to determine which nucleus is to 
bteloaded. 


The real storage size is limited by 
storing one of the foliowing hexadecimal 
values in location X‘'09°': 


Value Effective Size 
X*AT* 19 2K 
X"A8* 384K 
X*'Cé6* 64K 
x*CT* 128K 
x'cs* 256K 
x*cg° 512K 
X* po" 768K 
x* D1" 1024K 


If the operator limits real storage, 
IFAIPLOO clears real storage only up to the 
operator-selected limit. However, storage 
keys for all 2K segments of real storage 
are set, regardless of the artificial size 
limit. 


THE NUCLEUS INITIALIZATION PROGRAM 


NIP receives control from the Initial 
Program Loader to initialize system tables 
and control blocks, to make data sets and 
devices available for system use, and to 
bring into virtual storage those modules 
specified to be resident. The modules that 
compose NIP have the following residency 
characteristics: 

IEAVNIPO Loaded by IEAIPLOO as part of the 
nucleus; overlaid by subsequent 
NIP execution. 

1EAVNIPM Loaded into the highest rortion 
of NIP"s dynamic area by IEAVNIPO 
and deleted Ly IEAVNIPX; remains 
in real storage during execution 
of all NIP modules except 
IEAVNIPO. 

IEAVNP01 Loaded and deleted by IEAVNIPM; 
remains in NIP‘s dynamic area 
only during its execution. 
IEAVNPO02 Loaded and deleted by IEAVNIPM 
for use by NIP modules; remains 
in real storage only during its 
execution. 

IEAVNPO3 Loaded and deleted by IEAVNIPM; 
remains in NIP"*s dynamic area 
only during its execution. 
IEAVNPO4 Loaded and deleted by IEAVNIPM; 
remains in NIP*s dynamic area 
only during its execution. 
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ITEAVNPA4 Loaded by IEAVNIPM for IEAVNPO4 
and deleted by IEAVNP05; remains 
in NIP‘s dynamic area during 
execution of IEAVNPO4 and 

IEAVNP 05. 

IEFAVNP05 Loaded and deleted by IEAVNIPM; 
remains in NIP*s dynamic area 
only during its execution. 
IEAVNPA5 Loaded by IEAVNIPM for IEFAVNPO5 
and deleted by IEAVNP05; remains 
in NIP‘'s dynamic area during 
execution of IEAVNPO5; is 
executed under a TCB created as a 
result of an ATTACH macro 
instruction issued by IEAVNPO5. 
IEAVNP06 Loaded and deleted by IEAVNIPM; 
remains in NIP‘s dynamic area 
only during its execution. 
IEAVNPO?7 Loaded and deleted by IEAVNIPM; 
remains in NIP*s dynamic area 
only during its execution. 
IEAVNIPX Loaded by IEAVNIPM; remains in 
NIP‘s dynamic area only during 
its execution. Passes control to 
the master scheduler’s Initiali- 
zation routine (IEEVIPL). 


IEAVNIPO (DIAGRAM 2.0) 


The IEAVNIPO routine in NIP is link- 
edited with the nucleus modules to form the 
nucleus member IEANUCOx (IEANUCO1 if unSpe- 
cified) of the SYS1.NUCLEUS data set. IFA- 
VNIPO is entered only from the initial pro- 
gram loader (IEAIPLOO) and performs the 
initialization needed to load the first NIP 
module into NIP‘s dynamic area. Execution 
suksequent to IEAVNIPO causes the nucleus 
area occupied by IEAVNIPO to be overlaid by 
system data, and the area becomes a logical 
and physical extension cf the nucleus. 


IEAVNIPO does the following things: 


e Initializes the NVT (NIP vector takle) 
and the CVT (communications vector 
table). 


e Defines the real stcrage areas akove 
the nucleus (see Figures 4 and 5). 


e Defines the initial copy of the PVT 
(page vector table) and the PFT (page 
frame takle). 


e Defines the initial copy of the system 
trace table. 








1 
| System Queue Area | 


Variable 

| 

| Initial 

| Paging 

[ Space 

| 

Dynamic Area 
for 80K 

NIP's NIP Execution 
Nonpageable 
Region 


Figure 4. Definition of real storage 


e Initializes the segment takle and page 
tables (see Figure 6). 


e Sets the initial values in the System/ 
370 clocks. 


e Places the CPU in extended control (EC) 
mode with DAT enabled. 


e Defines a temporary nucleus buffer. 
e Defines NIP‘s nonpageakle region. 
e Reserves initial system paging space. 


e Initializes SYS1.NUCLEUS control 
blocks. 


e Passes control to IEAVNIPM (see Figure 
7). 


Paging Initialization 


IEAVNIPO creates the system segment 
table and the page tables in the high- 
address portion of the system queue area of 
real storage. The tables are used by the 
dynamic address translation feature to con- 
vert virtual addresses to real addresses. 
To better understand NIP‘s execution, it is 
useful to summarize the function of these 
tables in a virtual environment. 


Virtual addressing allows programs to 
refer to addresses that are greater than 
the size of real storage up to a maximum 
address of 16m-1. Virtual storage is 
divided into 64K segments, which are in 
turn divided into 4K blocks. Each 64K seg- 
ment is described by a 16-entry page takle, 
each entry describing a 4K Lklock. Each 64K 
segment is also associated with one of the 
256 entries in the system segment table 
which is pointed to by the CVTSEGD field. 
The addressing scheme (see Figure 8) multi- 
plies the first eight bits of a 24-bit vir- 
tual address by 4 and adds the result to 
the address of the system segment takle to 
arrive at the segment table entry for that 
virtual address. The next four bits in the 
virtual address are multiplied by 2, and 
the result is added to the 3-byte value in 
the segment takle entry to determine the 
page table entry for the virtual address. 
The page table entry contains the first 12 
bits of the real storage address of the 4K 
b-lock that contains the data referred to by 
the virtual address. The last 12 bits of 
the virtual address are used as the displa- 
cement into the 4K block to arrive at the 
real storage address of the data. 


IFAVNIPO creates only the page takles 
that describe virtual addresses correspond- 
ing to real storage addresses plus a single 
SQA segment. The appropriate (segment 
takle entries) are initialized for the page 
tables that are created. Unused segment 
takle entries are set to indicate that no 
corresponding page tables have been created 
for them. 


Because the virtual addresses of the 
nucleus are real addresses, the page takles 
that descrike the virtual area correspond- 
ing to the real storage area never change 
and are marked as valid. The area above 
NIP‘s region and below the SQA is reserved 
for paging. The page tables for this area 
are marked as invalid, because the real 
storage area associated with these page 
tables contains no valid data, and any 
reference to this area must be invalid. 

The page table created for the virtual 
storage area corresponding to the real 
storage SQA is also indicated as invalid, 
kecause the virtual area lcgically asso- 
Ciated with the SQA is in the high-address 
portion of virtual storage. Note that 
external page takles are not built, because 
neither the nucleus nor the SQA has a copy 
in virtual storage. External page tables 
normally follow page tables and descrite 
rage residency characteristics and location 
on paging devices. 
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IEAVNIPO execution 


EC Mode Initialization 


IEAVNIPO places the CPU in EC (extended 
control) mode by loading the PSW described 
below. This also allows all interruptions 
from the I/O subsystem. Previously, the 
system was disabled for all interruptions, 
including machine checks. 


Bit Value Description 
0 


0 Monitor mask -- disabled 

1 0 Program event recording mask -- 
disabled 

4 0 24-bit addressing specified 

1 Dynamic address translation -- 

enabled 

6 1 I/O mask ~- enabled 

7 1 External mask -- enabled 

8-11 0 Supervisor protection key 

12 1 EC mode 

13 1 Machine-check mask -- enabled 

15 0 Supervisor state 

24 0 Segment protection -- disabled 

40~63 Address of next sequential 
instruction 


Those fields not described are set to 0. 


The following multiple control registers 
are initialized by IEAVNIPO: 
Word Bits Description 

1 SSM interruptions 

8-9 Page size 
10 Page entry size 
11-12 Segment size 
Clock comparator 
21 CPU timer 
24 Location X'80" timer 
0-7 Segment table length 
segment table origin address 


KrF OOOCOC oO 
NO 
oO 


IEAVNIPM (DIAGRAM 3.0) 


IFAVNIPM consists of mainline coding and 
several subroutines. The subroutines are 
entered from the mainline processing, from 
other NIP modules, or asynchronously as a 
result of unusual conditions that arise 
during NIP execution. The mainline coding 
loads, Eranches to, and deletes the other 
NIP modules (except IEAVNIPX, which does 
not return control to IEAVNIPM). 


The subroutines within IEAVNIPM are 
requested by other modules via the IEAPMNIP 
Wacro instruction. The expansion of this 
Macro instruction includes a Branch and 
Link (BALR) instruction to the required 
subroutine, the address of which is 
cbhtained from the NIP vector table. If the 
subroutine NIPLOAD is reguested, the expan- 
Sion of the macro instruction also includes 
a Branch and Link to the requested module 
loaded Ey NIPLOAD and, for IEAVNPO2 subrou- 
tine requests, a subsequent SVC 9 (DELETE) 
instruction. The macro expansion does not 
include an SVC 9 instruction for IEAVNPA4. 
This module is deleted after execution of 
the macro expansion. 


NIPLCAD Subroutine (Diagram 3.1) 


The NIPLOAD subroutine is entered from 
various modules to load a specified NIP 
wodule into real storage. It creates a 
BLDL list via the BLDL macro instruction 
and issues a LOAD macro instruction. If 
the module is not loaded successfully, IEA- 
VNIPM places the system in a disabled wait 
State (X'32" or X'33'). 


NIPSVC and NIPSVCX Subroutines (Diagram 
3.2) 


The NIPSVCX and NIPSVC subroutines are 
entered aS a result of an XCTL request or a 
request for a type-3 or type-4 SVC. All 
Svc table entries for type-3 and type-4 SVC 
routines are set to the address of NIPSVC; 
the entry for XCTL is set to the address of 
NIPSVCX. Because the link pack area (which 
will eventually contain the required 
rodules) has not been initialized, the 
NIPSVC and NIPSVCX subroutines must load 
the module into real storage. Control is 
then passed to the XCTL module or to the 
SvC routine, and execution continues 
normally. 


NIPSENSE Subroutine 





The NIPSENSE sukroutine is entered fol- 
lowing an I/O error to write an interpre- 
tive error message to the master console. 
Information concerning the command code of 
the failing CCW, CSW status bytes, volume 
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Figure 8. 


Dynamic address translation 


serial number (if direct access storage 
device), EBCDIC unit address, and (if a 
unit check) sense bytes are extracted and 
placed in the error message, which is then 
sent to the operator via the NIPWTO subrou- 
tine (within IEAVNIPM). 


NIPUCBFN Subroutine (Diagram 3.3) 


The NIPUCBFN subroutine is entered to 
find a UCB related to a specific device. 
After converting the input, if necessary, 
to the hexadecimal unit address, NIPUCBFN 
issues, an IOSGEN macro instruction to link 
to the IOS UCB Lookup routine. I0S per- 
forms the necessary processing and returns 
the address of the associated UCB, if it 
was found. 
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NIPTIME Subroutine (Diagram 3.4) 


The NIPTIME subroutine is entered to 
provide either the time of day in decimal 
or the binary value representing the time 
elapsed since IEAVNIPM was entered for this 
initialization process. 


NIPWTO and NIPWIOR Subroutines 


The NIPWTO and NIPWTOR Subroutines are 
entered to build and execute a channel pro- 
gram to simulate WTO and WTOR macro 
instructions. IEAVNIPM has a temporary 
reply buffer into which the’ operator's 
reply to a WTOR is read. The requesting 
routine may specify that control is not to 
ke returned until the reply is received. 

In this case, NIPWTOR passes control to 
NIPWTOR2 to await the reply. 2 
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NIPWTOR2 Subroutine 


The NIPWTOR2 subroutine is entered to 
move an operator's reply into the rerly 
buffer specified by the calling routine. 
NIPWTOR2 returns control to the requesting 
routine or, if entered from NIPWTOR, 
returns control to the routine that 
requested the WTOR function. 


NIPABEND Subroutine 


The NIPABEND subroutine is entered asyn- 
chronously to process conditions that would 
normally cause abnormal termination of a 
task. Upon initial entry from IEFAVNIPO, 
IEAVNIPM replaces the SVC 13 address placed 
in the SVc table during system generation 
with the address of the NIPABEND subrou- 
tine. For the first entry to process an 
abnormal condition, NIPAREND issues a mes- 
sage to the operator via NIPWTO indicating 
the tyre of error and rranches to NIPSWAIT 
to place the system in a disabled wait 
state. For a recursive entry, the previous 
ABEND code is saved and the system is 
placed in a disabled wait state (X‘40"). A 
recursive entry might be caused by a fai- 
lure in NIPWTO. 


NIPSQEND Subroutine 


The NIPSQEND subroutine is entered from 
GETMAIN when an additional real page for 
the SQA is requested before the paging sub- 
system is initialized. The system is 
placed in a disabled wait state (X*°36"). 


NIPSWAIT Subroutine 


The NIPSWAIT subroutine is entered 
whenever an error condition prevents suc- 
cessful initialization of the system. NIP- 
SWAIT uses NIPWTO to notify the operator of 
the system wait state code and places the 
system in a disabled wait state. 


IEAVNPO1 (DIAGRAM 4.0) 


IEAVNP0O1 receives control from IEAVNIPM 
to initialize system consoles and to allow 
the operator to specify system parameters 
required for NIP execution. 


Initializing System Consoles 


IEAVNP0O1 uses several loops to determine 
the availability of and to initialize the 
system consoles. The first console 
examined is always the master console spe- 
cified in the UCM prefix during system 
generation. The NP1ITESTC subroutine is 
entered to build a CCW chain for the type 
of console being tested. An EXCP instruc- 
tion is issued, and the result of the I/0 
indicates whether the console is available. 
If the console is available, it is initia- 


lized as described below. After the con- 
sole is initialized, or if the console is 
not available, the other consoles in the 
Waster alternate queue are examined and 
initialized in a similar manner. 


When the end of the master alternate 
gueue is reached, IEAVNP01 searches, tests, 
and initializes all UCM entries keginning 
with that pointed to by UCMVEA. IEFAVNPO1 
then determines whether a master console 
has been found and initialized. If not, 
the system is placed in a disabled wait 
state (X‘'07'). 


The NP1INIT subroutine (see Diagram 4.1) 
initializes available consoles by (1) indi- 
cating that the console is active and (2), 
if the active master console is not the one 
specified during system generation, by 
copying the authorization and routing codes 
from the old master console to the new 
active master console and adjusting the UCM 
prefix/base. 


Initiating Operator Communication 


Immediately after the active master con- 
sole is initialized (and before the altern- 
ate consoles are initialized), the NP1IINIT 
sukroutine establishes communications with 
the operator by issuing message IEA101A 
SPECIFY SYSTEM PARAMETERS via the NIPWTOR 
subroutine in IEAVNIPM. The receipt of the 
reply is determined by the NP1TCOMM sukrou- 
tine, which is entered from the NP1iTESTC 
subroutine before consoles are tested for 
availakility. If a reply has been 
received, it is moved by NIPWTOR2 into the 
reply buffer area, a 2K area previously 
cbtained from sukpool 255 of the SQA. If 
additional parameters are to be entered, 
the message IEA116A CONTINUE SYSTEM PARAME- 
TERS is issued, and the reply to this is 
processed as akove. 


Before returning control to IEAVNIPM, 
IEAVNP01 ensures that no reply is outstand- 
ing to a message issued from this module. 


IEAVNPO2 (DIAGRAM 5.0) 


This module is initially entered from 
IEAVNIPM to initialize the devices in the 
system configuration that have not Leen 
initialized by IEAVNP01. It also provides 
system access to the SYS1.LOGREC, SYS1. 
SVCLIB, and SYS1.LINKLIB data sets. The 
subroutine NIPOPEN (entry point IEAVNPB2) 
is used ky mainline coding and by other NIP 
modules to open specified data sets. The 
subroutine NIPMOUNT (entry point IEFAVNPA2) 
is used only by other NIP modules to requ- 
est the operator to mount specified volumes 
on specified devices. 


Section 2: Method of Operation 19 


Mainline Coding 


IEAVNPO2 initializes the unit test DEB 
and its associated control blocks, which 
are defined within IEAVNP02. These are 
used for all I/O testing of devices. Using 
the UCB address takle, each device repre- 
sented by a UCB that was not examined by 
IEAVNPO1 is tested for availability. Fora 
DASD (direct access storage device), a 
channel program to read the volume label is 
created by the subroutine NP2RRCD3 and 
executed by the subroutine NP2EXCPU. For 
non-DASD, NP2EXCPU executes an I/O NOP CCW. 
Cevices that are not ready are so marked in 
their UCBs. 


After testing the system device confi- 
guration, SYS1.LOGREC and SYS1.SVCLIB are 
opened using the subroutine NIPOPEN. 
IEAVNPO2 builds the DEBs needed for the 
open processing. IEAVNPO2 also constructs 
the DEB associated with the SYS1.LINKLIB 
data set. 


NIPMOUNT Subroutine (Diagram 5.1) 


This subroutine is entered to request 
the operator to mount a specified volume on 
a device. The device may be specified by 
type or by unit. NIPMOUNT ensures that the 
correct volume is mounted on the device. 
Messages notify the console operator of the 
required action and indicate, where arpro- 
priate, incorrect and remedial action. A 
flowchart of this subroutine is included in 
Section 3. 


NIPOPEN Subroutine (Diagram 5. 2) 


This subroutine optionally Euilds the 
basic DEB and adds DEB extents for the spe- 
cified data set to be opened. 


IEAVNPO3 (DIAGRAM 6.0) 


This module is entered by IEAVNIPM to 
initialize the system parameter table 
according to the specifications given in 
response to the message SPECIFY SYSTEM 
PARAMETERS. Two sets of specifications are 
possible; operator entered, and system pro- 
grammer entered (via SYS1.PARMLIB). Figure 
9 describes system parameter area creation. 
The IEAVNP03 subroutines: 


e Analyze the parameters specified via 
the SYSP parameter and merge them with 
the parameters specified by the opera- 
tor in response to SPECIFY SYSTEM 
PARAMETERS. 


e Open SYS1.LINKLIB and concatenate mem- 
bers specified in the LNKLSTO0O0O member 
of SYS1.PARMLIB with the SYS1.LINKLIB 
data set. 
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Figure 9. Creating system parameter area 


NP30PSP_ Subroutine (Diagram 6.1) 


This subroutine uses the NP3SCAN subrou- 
tine to scan the parameters entered Ly the 
Operator in response to SPECIFY SYSTEM 
PARAMETERS. The subroutine moves the 
addresses of the valid parameters into an 
area within IEAVNP03 called OPERTAB. If a 
parameter is invalid, the operator is 
allowed to respecify or cancel it. Figure 
10 illustrates building the OPERTABE. 


NP3PBASE Subroutine (Diagram 6.2) 


This subroutine allocates a 2K area 
(PARMAREA) within NIP's dynamic area for 
later use by IEAVNP03. This area eventual- 
ly contains the valid system parameters. 
The lower-address part of PARMAREA is 
initialized to contain pointers to the next 
PARMAREA (considered secondary and tem- 
porary), to contain the next available area 
within PARMAREA, and to contain the IOB, 
DCB, and DEB for the SYS1.PARMLIB. The 
remainder of the PARMAREA is initialized by 
the NP3PTAB subroutine described below. 











NP3PMLIB Subroutine (Diagram 6.3) 


This subroutine finds and opens the 
SYS1.PARMLIB data set. 


NP3SYSP Subroutine (Diagram 6.4) 


This subroutine allocates a secondary 2K 
buffer (chained to the primary buffer, PAR- 
MAREA) and reads into it the parameters 
defined by the SYSP parameter. These para- 
meters are located in the I[LEASYSxx members 
of the SYS1.PARMLIB. The first member pro- 
cessed is always IEASYS00, which contains 
the values used for defaulted parameters. 


The NP3SCAN subroutine scans the farame- 
ters in the secondary Luffer and moves the 
addresses of the valid parameters into the 
area within IEAVNPO3 called PLIBTAB. When 
a parameter is specified more than once, 
the last specification is effective. The 
entries in both OPERTAB and PLIBTAB contain 
one address for each parameter (excert APG, 
PAL, and PAGE). Each entry reflects the 
last valid specification processed for that 
parameter. Figure 11 illustrates building 
the PLIBTAB. 


NP3PLMRG Subroutine 


This subroutine merges the parameters 
pointed to by the addresses in the OPERTAB 
and the PLIBTAB. When both tables contain 
entries for the same parameter, the OPERTAB 
entry replaces the PLIBTAB entry unless 
OPI=NO is indicated in the PLIBTAB for that 
operand. PAGE, PAL, and APG parameters are 
not merged. The addresses of the valid 
current system parameters are placed in 
PLIBTAB, overlaying the address of overrid- 
den parameters where necessary. Figure 12 
illustrates the merging of specifications 
into PLIRBTAB. 


NP3PTAB Subroutine (Diagram 6.5) 


This subroutine first removes all secon- 
dary PARMAREAs from the queue originating 
with the initial PARMAREA so that addition- 
al space required is pointed to by the ini- 
tial PARMAREA, instead of the last-acquired 
secondary PARMAREA. The area within the 
PARMAREA above the header (initialized by 
NP3PBASE above) haS two parts: (1) the 
PARMTAB which will contain the addresses of 
the parameters, and (2) the area into which 
the parameters will be moved. 


NP3PTAB begins moving the specifications 
for each parameter into the high-address 
portion of the PARMAREA while updating the 
corresponding addresses of the parameters 
in PARMTAB. In moving the parameters into 
the PARMAREA, NP3PTAB strips out superf- 
luous information, such as the keyword 
operands. Figure 13 illustrates building 
the final PARMAREA. 
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NP3LKLIB Subroutine 


This subroutine opens the SYS1.LINKLIB 
data set for later system use. 


NP3LCAT Subroutine (Diagram 6.6) 


This subroutine concatenates the data 
set members whose names are specified in 
the LNKLSTOO member of SYS1.PARMLIB data 
set with the SYS1.LINKLIB data set. A LOC- 
ATE macro instruction is issued for each 
member name found, and the resulting volume 
identification is passed to the NIPMOUNT 
Subroutine in IEAVNP02. The NIPOPEN sub- 
routine in IEAVNPO2 opens the data set and 
concatenates it with the previously defined 
portion of the SYS1.LINKLIB. The number of 
concatenations is limited to 15. 


IEAVNPOY (DIAGRAM 7.0) 


This module is entered only from IEAV- 
NIPM to process the PAGE, CLPA, CPQE, and 
SQA parameters and to initialize the con- 
trol blocks used by the paging supervision 
routines. IEAVNPO4 performs the following 
functions: 


e Interprets the PAGE parameters entered 
either in SYS1.PARMLIB or by the opera- 
tor in response to the message SPECIFY 
SYSTEM PARAMETERS. 


e Ensures that the paging devices are 
online and available for system uSe. 


e Ensures that the SYS1.PAGE data sets 
are available. 


e Expands the definition of the SQA. 


e Creates the page device table, rage 
device information table, page frame 
table, quickstart records, and the 
channel program queue. 


Processing PAGE Parameters 


IEAVNPO4S uses the system parameter table 
(PARMTAB) to locate the PAGE parameters 
included during system generation. A 16- 
entry matrix is created as a record of the 
parameters. IEAVNPO4 then processes the 
PAGE parameters specified ky the operator 
in response to SPECIFY SYSTEM PARAMETERS. 
Any value specified Ly the operator will 
override any corresponding specification 
already in the matrix. After optionally 
displaying the PAGE parameter values speci- 
fied, or if no PAGE parameters have Leen 
specified, the operator is allowed to 
change or add any PAGE specifications. 


22 


Initializing for Quickstart Records 


Because formatting of page data set 
records requires I/O overhead (a history of 
a successfully formatted page data set is 
kept within the data set), IEAVNPO4 allo- 
cates an 8K kuffer in the high-address por- 
tion of NIP's region. This buffer is used 
to build, write, and read records (called 
quickstart records) that describe the con- 
tent and extent of each fage data set. A 
quickstart record is built when a page data 
set iS initially formatted. IEAVNPO4 
attempts to read a guickstart record for 
each previously allocated page data set. 

If the read is successful, the data set is 
not reformatted. If the read is not suc- 
cessful, the data set requires reformat- 
ting, and a new guickstart record is 
created. 


NP4PCSEL Sukroutine (Diagram 7.1) 


This sukroutine scans the 16-entry 
Matrix Of PAGE parameters to determine spe- 
cifications for the paging devices. Each 
Specified device is tested for availabili- 
ty, and the operator is allowed to respeci- 
fy any device that is unacceptable or to 
cancel the definition. 


For each online and ready device, the 
NP4IPDT subroutine is entered to create the 
PDIT (page device information table) and 
the PDTE (page device table entry) for the 
device. Both entries are created in the 
upper end of the nucleus buffer. 


Upon completion of processing for this 
device, the PDIT is moved to its permanent 
Fositicn in the low area of the nucleus 
buffer. However, the PDTE is not moved 
until all matrix entries have been pro- 
cessed, because the final size of the PDIT 
is nct known until that time. The NIPOPEN 
subroutine in IEAVNP0O2 is entered to orfen 
the data set represented by the entry in 
the matrix. The NP4ROSR1 subroutine is 
entered to read the first quickstart record 
for the data set. If this data set repre- 
sents the quickstart LPA data set, and the 
CLPA parameter is not specified in PARMTAB, 
IEAVNPO&Y sets the NVTFLOS field to indicate 
that the page data set can be defined by 
the quickstart process. If this read is 
not successful, page forratting is 
required. 


If formatting is not required, the PDIT 
is moved from the temporary area to its 
fermanent position in the low area of the 
nucleus buffer, and additional device- 
dependent information is added. If format- 
ting is required, the NPA4INTF subroutine 
in IFAVNPA4 is entered to start formatting, 
and the ECB for the request (in the PDIT) 
is added to a list of ECBs that are tested 
prior to moving the PDTEs. 








When all matrix entries have been pro- 
cessed, the list of ECBs is checked to 
determine whether all formatting has been 
completed. As formatting for each data set 
is completed, a quickstart record (NIPQSR1) 
is built and written for the data set, and 
its PDIT is moved to its permanent posi- 
tion. When all PDITs have been rnoved, the 
PDTEs in the temporary position in the 
upper end of the nucleus buffer are 
scanned, and each valid PDTE is moved to 
its permanent position in the low end of 
the nucleus buffer above the PDITs. 


Figure 14 shows real Storage after pag- 
ing device initialization and initial pag- 
ing area definition. 


NP4BCPO Subroutine 


This subroutine defines the paging 
Supervision channel program queue at the 
high end of the nucleus. The size of the 
CPQ (channel program queue) depends on the 
number of paging devices in the system con- 
figuration. Ten CPQ elements are defined 
for the first paging device; 15 CPQES are 
defined if there is more than one device. 
In addition to the base number of CPQEs 
defined, the operator may specify an addi- 
tional number via the CPQE parameter. This 
number is added to the base number. 
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Figure 14. Real storage after paging 
device initialization and ini- 
tial paging area definition 


NP4APFT and NP4SBPFT Sukroutines 


Space for the page frame table is allo- 
cated ky NP4APFT in the low end of the nuc- 
leus buffer above the area occupied [ry the 
PDT. The page frame table is built by 
NP4BPFT. 


NP4YROSR2 Subroutine 


The LFA quickstart process is initiated 
if the NVTFLOS flag has been set by the 
NP4RQSR1 subroutine. The first and second 
LPA quickstart records are read into the 
quickstart buffer by NPA4READ in IEAVNPA4. 
The second quickstart record is required by 
NP4BSOA. 


NP4BSQA Subroutine 


This subroutine processes the operator- 
specified request to increase the size of 
the SQA. The value specified by the SQA 
Farameter is added to the basic size of the 
SQA to determine the new SQA size. If the 
operator specification would cause the SQA 
to extend into the quickstart LPA virtual 
Storage, thus causing a coldstart of the 
LPA, the operator is requested to either 
approve the coldstart process or to cancel 
the current SQA definition. 


NP4IPVT Subroutine 


This sukroutine initializes the page 
vector table to make the paging supervision 
control Elocks available for system use. 
After using the MODESET instruction to dis- 
able interruptions, CVTPAGE1 is set to the 
address of the DCB in the first PDIT (page 
device information table) created by 
NP4PDSEL. The PVIPDT, PVINPDTE, and 
PVTCHPGQ fields are initialized. The 
PVTPSQA field is restored to its original 
(upon entry to IEAVNIPM) contents. 


IEAVNPA4 (DIAGRAM 8.0) 


LEAVNPA4 is brought into real storage Ly 
IEAVNIPM and entered from the Page Initia- 
lization routine in IEAVNPO4. It is subse- 
quently entered from IEAVNPO4, IEAVNPOS, 
and IEAVNPA5S. IEAVNPA4 is deleted by 
IEAVNPOS upon completion of its execution. 
IEAVNPAY contains subroutines that: 


e Read and write quickstart records from 
and to the SYS1.PAGE data sets (NPA4- 
READ, NPA4WRIT). 


e Allocate space in NIP's dynamic area 
for the quickstart I/0 buffer 
(NPA4GBUF). 


e Initiate formatting of SYS1.PAGE data 
sets (NPAWINTF). 
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e Restart formatting of SYS1.PAGE data 
sets where a previous I/O error has 
occurred (NPAUWRSTF). 


e Initialize the paging tables for 
initiating the coldstart procedure for 
the link pack area (NPAYINTC). 


e Determine whether a specified load 
module will fit in the link pack area 
SYS1.PAGE data set (NPA4LOAD). 


e Complete the coldstart process 
(NPA4CCST). 


e Build cylinder count vectors for the 
SYS1.PAGE data sets and calculate the 
available pages (NPA4BCCV). 


e Release the space allocated for the 
quickstart I/O buffer (NPA4FREE). 


Each of these functions is rerformed by 
a subroutine within IEAVNPA4. The fourth 
and fifth bytes of the parameter list 
passed to IEAVNPA4 contain bit settings 
indicating which function is requested. 


NPAYREAD/NPA4WRIT Subroutines (Diagram 8.1) 


These subroutines read and write the 
quickstart records to and from the SYS1. 
PAGE data set. Because each quickstart 
record points to the next higher record 
(that is, record 1 points to record 2 
which, in turn, points to record 3), a 
request for quickstart record 2 or quick- 
start record 3 requires that the record 
fointing to it (quickstart record 1 and 
quickstart record 2, respectively) already 
be in the appropriate quickstart record 
buffer. 


NPAYREAD and NPA4WRIT rely on common 
coding to perform the requested I/O. They 
use a predefined IOB for scheduling I/0 
requests, but rely on the DCB and its asso- 
Ciated DEB, which are defined via the input 
DCB parameter. 


If an I/O error occurs during the execu- 
tion of the channel program, the NIPSENSE 
subroutine in IEAVNIPM is entered to write 
an interpretive error message. 


NPAYGBUF Subroutine (Diagram 8.2) 


This subroutine obtains an 8K area from 
subpool 252 of NIP‘s nonpageable region. 
Subsequent NIP execution requires that this 
area remain fixed in real storage. This 
area is used by NPA4READ and NPA4WRIT as 
buffers into which quickstart records are 
read. Quickstart records 1 and 3 are read 
into the lower end of the area (buffer 1); 
quickstart record 2 is read into the upper 
end (buffer 2). 
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NPAYFREE Subroutine (Diagram 8.3) 


This subroutine releases the quickstart 
record kuffer area obtained by NPA4GRUF and 
resets the pointers to the buffer area and 
to IEAVNPAY (in the NVT) to 0. 


NPAYINTF/NPAUYRSTF Subroutines (Diagram 8.4) 


These sukroutines initiate formatting, 
or restart formatting where previous for- 
Natting was terminated because of I/0 
error, of a SYS1.PAGE data set. 


There is one channel frogram built for 
each paging device supported by VS2. The 
appropriate build table is determined Ly 
using the device type indicator (PLTLT) in 
the page device table as a displacement to 
the addresses of the build tables within 
IEAVNPA4Y. The build table contains several 
entries, each of which is used to build a 
ccW for the channel program executed to 
format the page data set. 


The first two bytes in each build table 
indicate the number of CCWs required to 
format one cylinder of the device and ind- 
icate the number of count fields required 
by the channel program. Each of the two- 
rkyte entries that follow this header infor- 
mation has the following format: 


Bit Description 
0 1 = This CCW is for the last 


record on the track. 


1 1 = This is the last entry in 
the build table. 
2-15 Length of the record to be for- 


matted by this CCW. 


There is one entry in the channel pro- 
gram build takle for each data set record 
in one group for the device. 


NPAYECCV Subroutine (Diagram 8.5) 


This subroutine scans the auxiliary bit 
map field in a paging device table entry 
and totals the number of available pages. 


NPAYINTC Subroutine (Diagram 8.6) 


This subroutine is entered from IEAVNPA5S 
to initiate the coldstart process for the 
link pack area. Pertinent areas in the 
page vector takle that may be modified are 
saved within this module (it remains resi- 
dent during NIP execution). 


NPA4LOAD Subroutine (Diagram 8.7) 


This subroutine determines the number of 
pages of virtual storage required for the 
specified module and whether there are 
enough pages available in the LPA page data 
set to contain the module. 








NPAYCCST Subroutine (Diagram 8.8) 


This subroutine reinitializes page vec- 
tor table fields to their original contents 
upon entry to the NPA4SINTC subroutine. All 
pages currently in use by LPA modules are 
forced out of real storage, and the quick- 
start records are updated. 


IEAVNPO5 (DIAGRAM 9.0) 


This module is also entered from IEAV- 
NIPM. It defines the pageable link rack 
area either completely via the coldstart 
process, or uses a previously initialized 
LPA via the quickstart process. Quickstart 
records are written to the LPA SYS1.PAGE 
data set during a coldstart. Pageable LPA 
modifications, fixed LPA modifications, and 
the system BLDL table are optionally pro- 
cessed. IEAVNPO5 is also responsible for 
freeing the quickstart buffers obtained by 
IEAVNPA4Y and for deleting IEAVNPA4. 


NP5SQSLPA Subroutine (Diagram 9.1) 


This subroutine uses data in the guick- 
Start records to define the LPA page tables 
and external page takles. If this subrou- 
tine cannot be executed successfully, the 
coldstart process must be entered. 


NP5SCSLPA Subroutine (Diagram 9.2) 


This subroutine attaches the module IEA- 
VNPA5S, which contains subroutines to per- 
form requested coldstart functions. The 
interaction Letween IEAVNP05 and IEAVNPAS 
is maintained by waiting and posting indi- 
cations of segment processing completion 
(ECBS). NPS5SCSIPA uses internal subroutines 
and subroutines within IEAVNP05 to open the 
SYS1.LPALIB, initiate the coldstart pro- 
cess, and process modifications to the 
fixed link pack area and the system BLDL 
table. 


NP5SVTCB Subroutine (Diagram 9.3) 


This subroutine is entered to establish 
and to terminate the relationship between 
IEAVNPO5 and IEAVNPAS5. The subroutine NIP- 
LOAD in IEAVNIPM is used to bring IEAVNPAS 
into NIP‘'s nonpageable region. After the 
module is loaded, an ATTACH macro instruc- 
tion is issued to create IEAVNPAS as a job- 
steptask. Subsequent entries to IEAVNPAS 
are made via the NP5POST subroutine, which 
posts the ECB specified by IEAVNPAS and 
issues a WAIT macro instruction specifying 
an ECB for IEAVNP05. Control returns when 
the ECB for IEAVNP05 is posted by IEAVNPAS. 


When entered to terminate the relation- 
ship, NPSPOST reenters IFAVNPAS, which 
releases the previously allocated BLDL save 
area. Upon return, NPSPOST issues an SVC 9 


instruction to delete IEAVNPAS, releases 
storage and control blocks allocated to 
IEAVNPAS, and causes the attached TCB to be 
removed from the task queue and the suktask 
queue for the jok step. 


NP5LPLIB Sukroutine (Diagram 9.4) 


This subroutine is entered to ofen the 
SYS1.LPALIB data set so that modules can be 
loaded from it into the link pack area. 
NPSLFLIB issues a LOCATE macro instruction 
to determine whether SYS1.LPALIB is defined 
in the system catalog. If the correct 
entry is found, the NIPMOUNT subroutine in 
IEAVNPO2 is used to ensure that the volure 
is mounted and online. Upon return, the 
NIPOPEN subroutine in IEAVNP02 is used to 
cpen the data set. This request is condi- 
tional so that any error encountered during 
the cpen processing will not cause a system 
wait. Failure to open SYS1.LPALIB is indi- 
cated to the operator via a warning mes- 
sage, and to the calling routine via a 
return code of 4. Successful opening of 
the SYS1.LPALIB is indicated by setting 
NVTCSLIB to the address of the LPALIB DCB. 


NP5MLPA Sukroutine (Diagram 9.5) 


This subroutine is invoked uncondition- 
ally for both guickstart and coldstart pro- 
cessing to load LPA modules into the page~ 
able LPA whenever the MLPA farameter in the 
PARMTAB has a nonzero entry. The MLPA 
parameter gives the names of the SyYS1. 
PARMIIB members (IEALPAxx) that contain the 
names of the modules to Ee added. The 
NP5SVTCB subroutine is entered to attach the 
pageable task IEAVNPAS, which performs pro- 
cessing common to both guickstart and 
coldstart. The subroutine NP5MLPRM is used 
to load the specified modules one at a 
time. The CLEs for the loaded modules are 
removed.from the pageable TCB and placed on 
the active LPA queue by the NP5QLPAQ 
sukroutine. 


NPSBLDLP Subroutine (Diagram 9.6) 


This sukroutine is invoked uncondition~ 
ally whenever the BLDL parameter in the 
PARMTAB has a nonzero value. The BLDL 
parameter gives the name of the SYS1. 
PARMIIB member that contains the names of 
the modules to be included in the BLDL 
table. The valid module names in the fara- 
meter string are used to create a BLDL 
table in the nucleus buffer. NPS5SBIDLP 
issues a BLDI macro instruction when the 
table has been completed. The pageable 
task (IEAVNPA5S) is activated, if not alrea- 
dy active, via the subroutine NP5VTCB and 
entered to move the BLDL table to the area 
kelow the pageable LPA. NP5BLDLP places 
the address of the pageable BLDL taktle in 
the nucleus-resident BLDL SVC routine 
(IGC018). 
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NP5BLMQ Subroutine 


This subroutine builds a load module 
queue for IEAVNPAS based on the LPA packing 
list member of SYS1.PARMLIB. 


IEAVNPAS (DIAGRAM 10.0) 


This module is executed as a subtask of 
IEAVNPO5 and performs its functions as a 
pageable task. Interaction between 
IEAVNPO5 and IEAVNPA5 is governed by the 
use of WAIT and POST macro instructions 
Specifying ECBs related to the modules. 
That is, when IEAVNP05 requests a function 
of IEAVNPA5S, the pageakle ECB for IEAVNPAS5 
is posted, and IEAVNP05 issues a WAIT macro 
instruction specifying the nonpageable ECB. 
When the requested function has been com- 
Fleted, IEAVNPA5 posts the nonpageable ECB 
for IEAVNP0O5 and issues a WAIT macro 
instruction specifying the pageable ECB. 
IEAVNPAS is activated (attached) only if 
initialization is required for coldstart 
processing, if the MLPA option was 
selected, or if the BLDL option was 
Selected. 


Upon initial entry, a conditional GET- 
MAIN macro instruction specifying 16 mill- 
ion bytes is issued to allocate all of vir- 
tual storage in the pageable region to IEA- 
VNPA5. This allows IEAVNPAS to control 
allocation within the pageable region by 
issuing subsequent FREEMAIN macro instruc- 
tions for specific storage locations. A 
second GETMAIN macro instruction allocates 
64 bytes from subpool 255 of the SQA for 
BLDL entries initialized by IEAVNPA5. A 
skeleton BLDL header, which defines the 
Single BLDL entry as 60 bytes, is moved 
into this area. After initial processing, 
control is returned to IEAVNP05 by posting 
the nonpageable ECB. 


NPA5MLPA Subroutine (Diagram 10.1) 


This subroutine loads specified modules 
into the pageable LPA. The BLDL entry 
pointed to by NVIVRBLD is moved to the BLDL 
entry in the SQA, which was allocated by 
the NPASINIT subroutine within IEAVNPAS. 
The NPA5ADDR subroutine is used to deter- 
mine the address at which the specified 
module will be loaded. The nonpageable ECB 
is posted so that IEAVNP0O5 can continue 
execution. Upon return of control from 
IEAVNPO5, NPA5MLPA uses NPASLOAD to load 
the module into the LPA. 


NPA5BLDL Subroutine (Diagram 10.2) 


This subroutine allocates storage in the 
pageable area for the system BLDL table and 
moves the BLDL table from its temporary 
location in nonpageable storage. The NPA- 
5ADDR subroutine determines the address to 
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which the BLDL table should be moved and 
moves the takle to the newly allocated 
storage. The fields CVTSHRVM and NVTBLDL 
are reset to the address of the BLIL takle. 


NPASCLPA Subroutine (Diagram 10.3) 


This subroutine is entered to perform a 
coldstart process for the LPA. The NPA- 
4INTC sukroutine in IEAVNPA4 is invoked to 
ititialize PVT fields that will be used 
during the coldstart process. 


NPASCLPA calls the IEFAVNPAS5 subroutines; 
NPASCLIN, NPASIGRP, NPASLIND, NPASALIS, and 
NPA5EDIR to build the LPA. NPASCLPA then 
calls the IEAVNPAY subroutine NPA4SCCST to 
complete the coldstart process. 


NPASTERM Subroutine (Diagram 10.4) 


This Subroutine releases the real 
Storage allocated during the initial execu- 
tion Of IEAVNPA5. The pageable region is 
not released, since this would release the 
pages assigned to the pageable LPA and/or 
BLDL table. The pageable region srace is 
released by IEAVNPO5 when the subtask (IEA- 
VNPA5) is removed from the systen. 


NPASCLIN Subroutine 


This subroutine constructs the BLCL 
information table and determines the hash 
value. The BLDL information table (INFOLA- 
TA) contains flag bits and information 
extracted from the LPALIB directory. It is 
used to reconstruct a BLDL entry when load- 
ing a module. 


NPASLIND Subroutine 


This subroutine loads independent 
modules (those not loaded by NPASLGRP). 
When it can, which is most cases, NPASLIND 
tries to load the independent modules into 
pages which are not completely full. NPA5- 
LIND keeps track of these spaces with a 
"wasted space” table and a two-page area 
allocated above the BLDL information takle. 
The wasted space table has the size of the 
space and a pointer to a 3-word entry in 
the two-page area. The 3-word entry con- 
tains: the size of the space, the address 
of the space in the LPA, and a pointer to 
the next largest space entry. 


NPASALIS Subroutine 


This subroutine constructs LPDEs for all 
module aliases. 


NPA5SBDIR Subroutine 


This subroutine builds a permanent link 
pack area directory. 








CC 


NPASLGRP Subroutine (Diagram 10.5) 





This subroutine loads a group of modules 
Specified by the LPA packing 1ist. 


IEAVNPO06 (DIAGRAM 11.0) 


IEAVNPO6 contains the initialization 
routines for the RAS (reliability and ser- 
viceability) features of VS2 and processes 
the DUMP and TRACE system parameters. 


IEAVNPO6 contains a control routine that 
branches sequentially to four Separate pro- 
cessing routines. The control routine con- 
tains sequential calls to the four proces- 
sor routines. Each of the four processors 
initializes a separate RAS feature. 


The four RAS functions initialized by 
IEAVNPO6 are: 


1. DSS (Dynamic Support System) (for 
planning purposes only) 


2. SVCDUMP (SYS1.DUMP data set is opened) 


3. RMS (Recovery Management Support), 
consisting of CCH (Channel-Check 
Handler) and MCH (Machine-Check 
Handler) 


4. TRACE (system trace table is defined 
and initialized) 


NP6DSS Subroutine (Diagram 11.1) 


NP6DSS locates and prepares the DSS task 
for initialization. It locates and opens 
the SYS1.DSSVM data set and uses the rou- 
tine IEAQCDSR and IEAVVMSR to obtain the 
address of the LPA-resident DSS initializa- 
tion routine, IQAINI0O0O. NP6DSS places the 
address of IQAINIOO in the PSW in the PRB 
pointed to by the DSS TCB. At completion 
of DSS initialization, NP6DSS returns con- 
trol to the IEAVNP06 control routine. 


NP6DMP Subroutine (Diagram 11.2) 


NP6DMP analyzes the DUMP system paramet- 
er, and locates and opens the SYS1.DUMP 
data set for use by the SVCDUMP routine. 
NP6DMP determines whether the SYS1.DUMP 
data set is to go on a tape or a direct 
access device. NP6DMP opens the data set 
and returns control to the IFAVNP06 control 
routine. 


NP6RMS Subroutine (Diagram 11.3) 


NP6RMS issues the RMS macro instruction 
IGFVNIP, which initializes tne MCH and CCH. 
At completion of RMS initialization, NP6RMS 
returns control to the IFAVNPO06 control 
routine. 


NP6EXCE Subroutine 


NP6EXCP is a generalized I/O routine 
used by NP6DMP to read record 1 and write 
end-of-file in record 1 cf the SYS1.DUMP 
data set. NP6EXCP initializes the IOB, 
clears the ECB, and issues an EXCP instruc- 
tion. A WAIT macro instruction is used to 
wait for the I/O to complete. When I/O is 
complete, NP6EXCP returns control tc 
NP6DMP. 


NP6TRA Subroutine (Diagram 11.4) 


NP6TRA analyzes the TRACE system para- 
meter and defines and initializes the sys- 
tem trace takle. The nucleus initializa- 
tion program defines two trace tables, a 
temporary trace takle defined by IEAVNIPO 
and the permanent system trace takle 
defined Ly IEAVNP06. The permanent system 
trace table is defined in the last storage 
allocated in the nucleus buffer by NIP. 
This takes advantage of space that would 
otherwise ke wasted when the resident nuc- 
leus 1s rounded up to a 4K boundary. The 
entries in the temporary trace table are 
moved into the permanent trace takle during 
trace takle initialization. Both the tem- 
porary and permanent trace tables are con- 
structed similarly and consist of a vari- 
able number of 32-byte entries. The numker 
cf entries in the temporary table is speci- 
fied during system generation, while the 
permanent takle size may be specified eith- 
er during system generation or during nuc- 
leus initialization. Each entry contains 
information about an event (most often an 
interruption) and is recorded ky the system 
at the time the event occurs. 


Three fullwcrd rointers, which cccupy 
the 12 rytes preceding the first entry, 
define the dimensions of the trace takle. 
The first pointer, which is located through 
fixed storage location X'54* (FLCTRACE) and 
a secondary CVT pointer (SCVTRACE), foints 
to the current or most recently recorded 
entry. The second pointer points to the 
first (lowest storage address) entry in the 
table, and the third pointer points to the 
highest entry in the table. 


Entries are made in ascending order in 
the trace takle, beginning with the lowest 
address. When the highest entry area in 
the takle is filled, the next entry is made 
in the lowest address space, overlaying a 
Erevious entry. 


NP6MCVE Subroutine 


This iS a common routine used to move 
variakle-length areas of storage in incre- 
ments of 256 bytes or less. 
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LEAVNPO? (DIAGRAM 12.0) 


IEAVNPO? is entered from IEAVNIPM pri- 
marily to process the HARDCPY and PAL sys- 
tem parameters. IFAVNPO?7: 


1. Defines the unit that is to be used as 
the hardcopy log for console messages 
and/or displays. 


2. Defines the location of LPA-resident 
DCMs (display control modules) that 
are used by the graphic console sup- 
port processors to buffer display 
images for individual consoles (graph- 
ic consoles only). 


3. Defines the limit and threshold values 
for the paging supervisor algorithms. 


4. Locates the SVC OPEN Router in the 
LPA. 


5. Tests tor the presence of the 
extended-precision floating-point fea- 
ture (except divide). 


NP7HDCPY Subroutine (Diagram 12.1) 


NP7VHDCPY analyzes the HARDCPY parameter 
and identifies the console or system log 
data set to ke used for the hardcory 1og. 


NP7HDCPY alerts the operator if the HAR- 
DCPY parameter was specified incorrectly, 
if the hardcopy console is not available 
(console was offline during IEAVNP01 con- 
Sole initialization), or if the specified 
device address does not represent a unit 
that was defined during system generation 
aS a console with hardcopy capabilities. 
If the NP7HDCPY routine prompts the opera- 
tor to specify HARDCPY, the operator is 
permitted to continue the parameter speci- 
fication to a second line. 


NP7PDCM Subroutine (Diagram 12.2) 


NP7PDCM identifies the pageable DCM 
(display control module) addresses for dis- 
play consoles (2250, 2260, 3270, 3155, and 
3060). The DCM addresses are defined in 
the nucleus for later use by the communica- 
tions task. When the last UCM entry has 
beer. examined, NP7PDCM returns control to 
the IEAVNPO7 control routine. 


NP7LPAFN (Diagram 12.3) 


This subroutine is called by NP7PDCM and 
NP7OTEST to search the LPA for a specified 
module. Preference is given to a module 
found in the fixed LPA or the LPA update 
area (sometimes called LPA modifications). 
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NP7PAL Subroutine (Diagram 12.4) 


NP7FAI analyzes the PAL (paging 
algorithm limit) system parameters speci- 
fied via the SYSP parameter or ky the 
cperator and establishes paging supervision 
limits and threshold values. NP7PAL, 
cptionally, displays the PAL subparameter 
values that result from the analysis and 
allows the orferator to respecify the PAL 
parameter. 


NP7JOTEST Subroutine 


NP7CTEST determines whether the SVC OPEN 
Router (IGFOI9RA) is in the link pack area. 
If found in the LPA, its entry address is 
stored at CVTDMSR. If not found in the 
LPA, the operator is notified, and the sys- 
tem is put in a disabled wait state 
(X"3RB'). 


NP7VEPFP Subroutine (Diagram 12.5) 


This subroutine tests for the presence 
of the extended-precision floating-foint 
feature (excert divide) in the hardware. 
The divide capability is not normally fre- 
sent in System/370 CPUs and the Model 145 
May lack the other floating-point features. 
Thus, it is necessary to place in the CVT 
an indication of the extended-precision 
floating-point capabilities of the CPU. 


ITEAVNI PX 


IEAVNIPX is the last module to receive 
control during VS2 initialization. It: 


e Defines the upper limit of the area 
which may be assigned to nonpageakle 
joks (NPXREAL). 


e Defines the task dispatcher's APG 
(automatic priority group) (NPXAPG). 


e Defines the task diSpatcher's time- 
Sliced prioity groups (NPXTMSL). 


e Cefines guickcell areas (NPXQCELL). 


e Lefines the master scheduler region 
(NPXMPA). 


e Establishes limits on use of auxiliary 
storage ky TSO and kackground tasks 
(NPXMPA1). 


e Releases NIP buffer space in the SQA 
(NPXFBUF). 


e Releases control blocks for NIP-loaded 
modules (NPXFJPQ). 


e Defines available address space 
(NEXFAREA). 
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e Defines the master shceduler‘'s LSQA 
(NPXMLSQA). 


e Defines availakle page frames 
(NPXPFTAQ). 


e Defines shared subpool 0 for the master 
scheduler and communications task 
(NPXMCSPO). 


e Releases NIP's trap on ABEND 
(NPXRTRAP). 


e Resets the dynamic address translation 
tables and exits to the master schedul- 
er initialization program (NPXRDAT). 


IEAVNIPX processes the APG, TMSL, MPA, 
REAL, SQACEL, LSQACEL, TSOAUX, and AUXLIST 
System parameters. 


IEAVNIPX Control Routine (Diagram 13.0) 


The Control Routine organizes NIP exit 
processing by sequentially invoking the 
various exit subroutines. 


NPXREAL Subroutine 


NPXREAL interprets the REAL system para- 
meter, defines the nonpageable dynamic 
area, and ensures that the numker of non- 
pageable pages being defined does not con- 
flict with the previously defined NFX= sub- 
parameter of the PAL= parameter. 


NPXREAL locates, via PARMTAB, the REAL 
parameter input and ensures that the value 
is not too large. NPXREAL determines the 
new upper boundary of the nonpageable area 
and stores it at CVTREAL. NPXREAL also 
stores the index of the PFTE that corres- 
ponds to the page containing the high non- 
pageable address in the PVT at PVTIVEQR. 


If the REAL parameter is incorrect, 
NPXREAL informs the operator by calling 
NIPWTOR to send a message. The operator 
may respecify or cancel. If he respecifies 
it, it is processed as above; if he cancels 
it, NPXREAL attempts to use a system- 
assigned value, as described below. 


If the REAL parameter is not specified, 
the nonpageable dynamic area is set to 64K. 
If this area cannot ke contained below the 
Minimum system paging/SQA space, the NIPS- 
WAIT routine (in IEAVNIPM) is entered to 
place the system in a disabled wait state 
(X'38'). A message is first issued indi- 
cating that storage is not available for 
the nonpageable area. 


NPXAPG Subroutine (Diagram 13.1) 


NPXAPG interprets the APG system para- 
meter and defines or cancels the task dis- 
patcher's automatic priority group. 


NPXTMSL Subroutine (Diagram 13.2) 


NPXTMSL interprets the TMSL system para- 
meter and defines or cancels the task dis- 
patcher‘s time-sliced priority grours. 


NPXQCELL Subroutine (Diagram 13.3) 


NFXCCEIL interprets the SQACEL and LSQA- 
CEL system parameters and defines the quic- 
kcell areas for SQA or LSQA, or both. 


NPXMPA Subroutine (Diagram 13.4) 


NPXMPA interprets the MPA system fara- 
weter, which allows address space, in 64K 
segments to be added to the master schedul- 
er region (128K Lytes by default) and 
defines the virtual address space dedicated 
to the master scheduler region. 


NPXMPA1 Subroutine (Diagram 13.5) 


NPXMPA1 is called by NPXMPA to interpret 
the TSOAUX and AUXLIST system parameters 
and to establish limits on background and 
TSO use of auxiliary storage. 


NPXFBUF Subroutine 


NPXFBUF releases the storage occupied Ly 
the NIPSPE queue in SQA. NPXFBUF calls 
FREEMAIN to free each NIPSPE on the NIPSPE 
queue except the one in the NVT. 


NPXFBUF invokes the IFAVNIPM subroutine 
NIPWTOR2 to release any dynamically 
acquired SQA reply buffers. NIP buffers in 
NIP‘s region space are released when the 
dynamic area is redefined by the NPXMPA and 
NPXFAREA routines. 


NPXFJPQ Subroutine (Diagram 13.6) 


NPXFJPQ purges programs loaded Ly NIP 
that still remain on NIP‘s TCB job pack 
queue. The purge is logical only, since 
the CDEs and LLEs representing these pro- 
grams are dequeued and the storage the CDEs 
and ILLES, occury is released while the 
storage the programs occury is not released 
until availakle storage is redefined by the 
NPXFAREA routine. 


NPXFAREA Subkroutine 


NPXFAREA defines the pageable and non- 
pageable address space that is availakle 
for later region and LSQA allocation. 


NPXFAREA redefines the nonpageakle PQE 
and FBQE to include the address space iden- 
tified by NPXREAL beginning at the top of 
the nucleus. NPXFAREA urdates the pageakle 
POE and FBQE to reflect address space 
beginning at the end of the nonpageakle 
dynamic area and extending to the low 
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address of the master scheduler region 
identified by NPXMPA. 


NPXMLSQA Subroutine (Diagram 13.7) 


NPXMLSQA allocates the single-segment 
LSQA related to the master scheduler 
region. This is done by means of a special 
interface to virtual storage supervision 
that is used only by NIP. The special 
interface is needed because NIP defines the 
LSQA without a TCB. This action prevents 
wasting space for a duplicate and unused 
TCB. 


NPXPFTAQ Subroutine (Diagram 13.8) 


NPXPFTAQ scans the paging supervisor's 
PFT (page frame table) and adds NIP's non- 
pageable area to the available PFT queue. 
NPXPFTAQ moves to the available queue all 
page frames that are assigned to a nonpage- 
able region. 
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NPXMCSPO Subroutine (Diagram 13.9) 





NPXMCSPO defines the master scheduler 
subpool 0 as shared with the communications 
task. This allows the ccmmunications task, 
which is defined without a region, to 
acquire storage in the master scheduler 
region. 


NPXRTRAP Subroutine 


NPXRTRAP restores the SVC table entry 
for ABEND (SVC 13) to its original contents 
upon entry to NIP. 


NPXRCAT Subroutine (Diagram 13.10) 


NPXRDAT sets up the input parameters for 
the master scheduler Initialization program 
IEEVIPL, resets the dynamic address trans- 
lation takles, and terminates supervisor 
initialization by issuing a LINK macro 
instruction to IEEVIPL. 
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Diagram 1.0: IEAIPLOO 

De ng ag ae a ee ee en EE pa oe ee Gi Sa ge ee ea ie te ay ae aes ag ee st eG Mice ee Jee 
| Notes on Processing | Label | | Notes on Processing | Label 

| ---------------------------------------}----------4 }--------------------------------------- +---------- { 
| 1. The EBCDIC character at location |IEASTAR1 ; 4Y. <A Set Storage Key instruction is’ |IEAMXLOC 
| X'08" is a suffix appended to | | | used ina loop to set the storage | 

| “IEANUCO" to form the nucleus | | keys for all 2K-multiple blocks to| 

| member name. The system assigned | | | 0. | 

| character "1" may be replaced by | | | | 

| the operator by setting an address| | | 5. The halfword at location XK'02‘ is |IEAPCKEY 
| stop at location X‘'80' before pre-| | | used to determine the location of | 

| SSing the LOAD button. When the | | | the device that contains the nuc- | 

| address stop is reached, the | | | leus data set (SYS1.NUCLEUS). | 
operator overlays the "1" with the| | | | 

| desired EBCDIC character. | | | 6. The coding in IEAIPLOO beginning’ |IEAADCRS 
| | | | at label IEADATDS is relocated | 

| 2. The contents of location X‘'09' are| | above the area to be occupied Ly | 

| used to determine the effective [ | | the nucleus. Control is passed to| 

| Size of real storage. Using the | | | the relocated coding which sets to| 

| address stop procedure described | | | 0 the area from which it was | 

| in Step 1, the operator may speci-| | | relocated. | 

| fy that effective real storage | | | | 

[ Size 1S to be less than the real _ | [ | 7. The text records of IEANUCOx are’ |IEARD1 

| Storage size. One of the follow- | | | read into the low end of real | 

| ing hexadecimal values must be | | | storage (see Figure 3). | 

| inserted in location X‘'09°: | | | | 

| | | {| 8. Location X'16C" contains an LPSW- |IEAOUTCD 
| X"A7" - 192K, X‘A8" - 348K, | | | instruction that Specifies the PSW| 

| X'C6" - 64K, X'C7" - 128K, | [ | at location X'170‘'. This PSW spe-| 

| X'C8" - 256K, X‘'C9* - 512K, | | | cifies the entry point in IEAV- | 

| X*'DO* - 768K, X'D1' - 1024K | | | NIPO, the first NIP module. | 

| l | pe en mee Rg yO Re ee eee a eee 
| 3. The real storage area akove | | 

{ IFAIPLOO is set to 0 by a Move | | 

| Character instruction ina loop. | | 

OS a ee ee ees Sapa eee ees rere J 


he 


Diagram 1.0: IEAPILOO (Cont'd) 








Co eee ee ee ee ee coo 1 as a a a ae Se ee eae 
| Notes on Processing | Label | | Notes on Processing | Label | 
Pe oe eee | gaianierir ne oes < qos pean ao oR EE rR { 
| Error conditions that can occur during| | | X*06° The CSW stored after a TIO | ERRCSW | 
| execution of IEAIPLOO result ina | [ | operation indicates that a [({CSWTST) | 
| disabled system wait state with the | | | program check, channel data [ | 
| appropriate wait state code displayed | [ [ check, channel control check, | | 
| in the lights on the CPU control panel| | | channel chaining check, or | [ 
| and stored in the address portion of | | | interface control check | | 
| a current PSW. The wait state codes | | | occurred. | { 
| are: | | | | | 
{ { ; | x*Oc‘ The active nucleus member | ERRSCTR | 
| x*O1' First Test I/O instruction | IEAERR1 | | IEANUCOx is not edited in | (IEANONPM) | 
| indicates that I/O is not | (IEAIOTST) | | Scatter format and cannot be | | 
| operational. | [ | loaded by IEAIPLOO. | | 
| | | | | 
| X*02° An I/O instruction could not | ERRSIO2 | | X*OE* The SYS1.NUCLEUS data set or  |ERRNUC | 
[ be started; a Start I/0 | (LEASTRIO) | | the active nucleus member | (TLEACOMPR) | 
| instruction resulted in a CSW | [ | IEANUCOx was not found on the | (SENSE) | 
[ being stored for reasons other| [ [ IPL volume on the device spe- | { 
| than unit busy (CU kLusy or CU | | | cified by the address in kytes| | 
[ end). { | | X02" and K'Q3'. The nucleus | | 
| | | | cannot be loaded by IEAIPLOO. | { 
{| x‘'0O3° An I/O operation could not be | ERRSIO3 | | | [ 
[ Started; the CSW was not | (LEASTRIO) | [. Ae A unit check occurred follow- | ERRSNS | 
| stored. | [ | ing a successfully started I/0| (SENSE) { 
| | | i Operation (either a Sense I/O | | 
| x*O4' The CSW was not stored follow-| ERRTIO { | or an attempt to read the home| | 
| ing an SIO/TIO sequence; chan-|(IEATSTIO) | { address and record 0 of a | | 
| nel was not k;usy. | [ | track that previously caused a| | 
| [ | { track condition check). | [ 
| x‘0O5' A unit check occurred follow- | ERRUCK i | | 
[ ing a successfully started I/0| (SENSE) | | x'18° Availakle space for nucleus | IEAERR8 | 
| operation. The unit check was|(SNSPRCD) | [ RLD records has been exceeded; | (IEABLIDRL) | 
| not caused by a track- | CECFMERFX) | [ there is insufficient space to| | 
| condition check, a file mask | | | load IEANUCOx. | | 
| violation/end of track, or an | | | | | 
| end of cylinder. The first | { | x*19° An unexpected program check | [ 
| four bytes of sense data are _ | [ | occurred. IFAIPLOO has not | [ 
| end of cylinder. The first | CECFMERFX) | [ finished loading the resident | | 
| four bytes of sense data are _ | i | nucleus. Either IEAIPLOO is | [ 
[ saved at location X°54°; the _ | | | in error or the storage in | | 
l address of the failing CCW | | { which it resides is failing. | | 
{ string is saved at location | { t_----—-—-~-~---~~-—~—----------~--+-------- +—1---------~ 4 
X*4HC*. | { 
UE a hr ee ee ape J 
‘ 4 : * 





¢ SOON 


9E 





re 


VIMSTCB 


Real Storage Location X'10' 


Address of CVT 


Register 10 
Address of IPL device 


Register 3 
Address of IPLDATA 


IPLDATA 





From Diagram 1.0, 


Step 8 


= T —. 2 Initialize NIP vector table and 


Processing 


IEAVNIPO 


— — —— — — F 1 Ensure that IEAVNIPM was found in 


SYST.NUCLEUS by IEAIPLOO. 


communications vector table. 


3 Ensure that 16 pages are available for 
nucleus buffer and initial paging space. 


4 Define real storage areas above the 
nucleus (see Figure 4). 


== 5 Initialize UCB of IPL device. 


eames | 


oe es 6 Initialize SYS1.NUCLEUS DCB. 


(Continued at Step 7) 


Not found 


Less than 
16 pages 


UCB not found 


Diagram 2.0 (1 of 3): IEAVNIPO 
Initial NIP Processing 


Output 





System WAIT 
X'32' 





NVTTRACE 


| NVTNUCND | 









CVTEORM 


CVTNUCB 


















System WAIT 
X'38' 





CVTNUCLS 






- 





IOSGEN 
4 Find IPL UCB 


System WAIT 
X'31' 


ct IECPRLTV 


CCHH to TTR 


conversion 
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Diagram 2.0: 


Pen ee ec rs ge SF ge FE ce or og rs ge oe oe oe es 


1. 


© 
e 


Notes on Processing 


+ a ne a a eg ee ee ee ee ee 


IEAVNIPO 


IEAVNIPO exists immediately above 
the nucleus if IEAVNIPM was found 
in the SYS1.NUCLEUS data set. 


The highest four pages in real 
storage are allocated to the sys- 
tem queue area. An 80K portion of 
the area between the nucleus and 
the SQA is allocated to NIP as a 
dynamic execution area. The area 
not allocated to NIP or SQA is 
divided equally kLetween the nuc- 
leus buffer as subpool 251 in 
NIP‘'s region (adjacent to the nuc- 
leus) and the initial paging space 
(adjacent to the SQA). 


IPLDATA 1S described in Section 5. 


The four pages allocated to the 
SQA in Step 4 are initialized as 
shown in Figure 5. Until the 
pageable storage space is defined 
(by IEAVNPO4), all requests for 
SQA must be satisfied form the 
minimum four pages. A trap rou- 
tine and a system wait state are 
defined in IEAVNIPM to terminate 
initialization if the SQA is 
exhausted. 


The entry in the Svc table for SVC| 
13 1S replaced with the address of| 
the ABEND trap routine within IEA-| 
VNIPO (label NPOABEND). This rou-| 
tine processes unexpected ABEND | 
conditions and causes a system { 
wait state (X‘'30'). | 


IEAVNIPO 


NPOUCBLK 


NPOSQINT 


| eee —_ — 
r ae a 


- 
© 


I 
ren 


- 
NO 


T 
| 

4 

The temporary page frame table is | 
kuilt at the top of the nucleus | 
buffer and contains PFTEs (page | 
frame takle entries) for each page| 
in the initial SQA. These PFTEs | 
are initialized with the virtual | 
block numbers; the first and last | 
klock numbers are placed in the | 
page vector table in the nucleus. | 
The apparent PFT address is set to| 
the real storage address where the| 
first PFTE would exist if there [ 
were PFTEs for real storage page | 
frames. | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


The number of trace table entries 
is zero if the TRACE option was 

not selected during system 
generation. 


The trace takle is defined at the 
high end of the nucleus Luffer 
(keneath the page frame table). 


The system segment table and fage | 
takles for all of real storage are| 
defined in the upper area of the | 
SCA (see Figure 6). No external | 
page table entries are built [ 
kecause no areas represented by [ 
the system segment table are | 
paged. Space is reserved between | 
the system segment table and the | 
first (SQA) page table for the | 
user segment table which will be | 
defined during IEAVNIPX execution. | 
All page table entries for real { 
storage between NIP's region and | 
the SQA are flagged as invalid, | 
and corresponding segment table | 
entries are flagged as | 
page-table-not-—defined. | 

1 


NPOATINT 
NPOSTELP 
NPOVRUN 


am es capes cs ce ee cs ss ee ee ee ok — ~ 


BE 





Input 


Register 6 


Effective real storage 
size 


NVTCMTCB 


CVTNUCB 


‘ 

v. y 
~ cel 

we, 

=~ * . 

4 ers 


ery 


» eet 


uot > 
’ 


NVTSQANO 

we a ‘f 
NVTTRACE 
NVTNBFND 


ee = 


NVTSQANO 


NVTIPGNO 


Diagram 2.0 (2 of 3): IEAVNIPO 


Initial NIP Processing 


Processing Output 


Communications task TCB 
PSN 


e ‘ i 
7 Initialize the system queue area. Address of dummy PQE 


Master scheduler TCB 


D> ere 2 Pe Pgh 
rE oo as 7 “ iy > 


Tie Se ae 


Modify SVC table to intercept abnormal Be — ~ 
termination conditions. ee ie 
NVTSAV 
SS vet Ft 
SR 
SVC table 
eee 
a ea 
Initialize page frame table and page ABEND entry 
vector table. PS 8 ~ 


4 
ae re FA 


Determine whether trace option was Not selected Trace table 


selected. 12 SRR eto yt a = 
TRPTR 


Initialize trace table. TT i Md CEES 4 
Bey Aa 


Table exceeds i 


nucleus buffer System WAIT 
X'38' 


Define initial system segment table and 
page tables (see Figure 3.3). 


SCVTRPTR 


Replace system-generated program-check Reali stiorages!Gcahion: 7.06 


PSW with X'34! wait state PSW. Se 


(Continued at Step 14) 
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Diagram 2.0: 


IEAVNIPO (Cont'd) 


This causes a system wait state 
(X°34") when a System/370 instruc- 
tion or an instruction that 
requires the dynamic address tran- 
Slation feature is executed on a 
system that does not include this 
feature. 


Error Processing 


| 

F 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| Abnormal error conditions result ina 
| disabled system wait state with one of 
| the following codes being stored in 

| the address field of the current PSW 

| (bits 56-63): 

| 

| x'30° An unexpected ABEND request 

| has occurred. The system com- 
| pletion code is found in bits 
| 36-47 of the current (wait 

{ state) FSW. 
| 

| x°31° The IPL volume resides on a 
| unit for which no UCB was 

| found. 

t 


a oe es es ee © ee ee ee 2 © oe © © 2 © 9 ee © 2 © © 2 ee 2 2 ow oe oe oe = oe 


|NPOFRR32 


IEAVNIPM was not found in the 
SYS1.NUCLEUS data set. Bits 
36-47 of the current (wait 
State) PSW contain X'7D4' 
last 12 bits of the EBCLIC 
nare “IFAVNIPM"). 

4°33" An I/O error occurred during 
BLDL processing. Bits 36-47 
of the current (wait state) 
PSW contain X‘'7D4' (the last 
12 bits of the EBCDIC name 
"“ITEAVNIPM"). 

X'34' An instruction that requires 
the dynamic address transla- 


tion feature has been executed| 
on a CPU that does not include| 


this feature. 


There is insufficient real 
storage for VS/2 to be initia- 
lized by NIP. 


NPOERR33 


NPOERR38 


' 
| 
| 
| 
| 
| 
| 
| 
| 
| 
\ 
\ 
l 
| 
| 
| 
\ 
| 
l 
l 
| 
l 
1 
\ 
\ 
l 
l 
| 
! 
l 
| 
1 
| 
l 
| 
l 
| 
! 
| 
bk 
1 
| 
\ 
1 
| 
1 
\ 
l 
| 
l 


Of 


Processing 


14 Store model number, 
15 Format control registers 0 and 1. 


16 Set CPU timer and clock comparator to 
prevent timer interruptions. 


17 Load PSW to enter EC (extended control) 


mode, 


18 Restore system-generated program-check 
new PSW. 


19 Load IEAVNIPM, 


20 Initialize registers. 





BLDL 
Read PDS 


IEAVNIPM 
Diagram 3.0, Step 1 


Diagram 2.0 (3 of 3): IEAVNIPO 
Initial NIP Processing 


Output 





CVTMDL 


seal storage location X'68' 


Register 1] 


Address of SYS] .NUCLEUS 
DCB 


Register 2 


Address of NVT 
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Diagram 2.0: IEAVNIPO (Cont'd) 


a 
| Notes on Processing | Lakel | 
bee a ee aa ee ta eee 

{ 17. |NPOELPSW | 
Ma rs a ees Baye ener era J 


ch 





Diagram 3.0: IEAVNIPM 
Control! Routine 


From Diagram 2.0, 
Step 20 





Input 


Processing Output 





















EA 
Register 2 HEINE 


ae << ———_— Move contents of initial NIP vector table 
from IEAVNIPO to IEAVNIPM and save 
TOD clock value. 





Move contents of SYST.NUCLEUS DEB 
extent from IEAVNIPO to IEAVNIPM, 





Initialize SVC table to intercept XCTL, 
ABEND, and type-3 and type-4 SVC 
requests and initialize PVT intercept 


CVTPVTP 
get -SQA-page requests. 









Be Pop eee? eg eT 
4 Sequentially load, branch to, and, upon 
return from, delete the following NIP 
modules: 
IEAVNPO1 
JEAVINPO2 
IEAVNPO3 
JEAVNPO4 
JIEAVNPOS 
IEAVNPO6 
IEAVNPO7 












NIPLOAD 













DELETE 


5 Load and branch to IEAVNIPX, NIPLOAD 


JEAVNIPX 
Diagram 13.0, Step 1 
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Diagram 3.0: IEAVNIPM 


T 
Notes on Processing [ 


1%) 
° 


A 
r 


The initial NIP vector table in | 
IEAVNIPO is moved to corresrfonding| 
fields in IEAVNIPM, thus relocat- | 
ing the NVT. 


| 
The addresses of the Intercept | 
routine for ABEND (NIPABEND), XCTL| 
(NIPSVCX), type-3 and type-4 SVc_ | 
routines (NIPSVC), and the Get- { 
SQA-Page routine (NIPSQEND) are | 
placed in the appropriate loca- | 
tions in the SVC table and the | 
page vector table (NIPSQEND). | 
Entry to NIPSQEND is from virtual | 
storage management; other entries | 
are from the SVC Second-Level | 
Interruption Handler. NIPSQEND | 
causes a system wait state | 
(X"36°). NIPABEND causes a system| 
Wait state (X'40'). NIPSVCX and _ (| 
NIPSVC are described by Diagram | 
oe | 

| 


IEAVNIPM uses a series of suffixes| 
and an index to these suffixes in | 
the NVT that are appended to the | 
base name "IEAVNP" to determine | 
which NIP module is to get control| 
next. Each module is loaded by | 
the subroutine NIPLOAD, branched | 
to, and deleted. The last value, | 
07, is followed by X‘'FF", which | 
indicates that the last NIP | 
module, IEAVNIPX, is to be | 
entered. This module is loaded | 
and branched to similarly; but, | 
because control does not return, | 
IEAVNIPX is not deleted by | 
IEAVNIPM. | 

i 


a ee ae ee ee ee ee ee es ee ee ee ee ee ee oe ee ee ee oe eee oe oe ee oe eo oe 


IEAVNIPM 


NPMNEXT 


ht 


Diagram 3.1: NIPLOAD 
Load Specified Module 


From Diagram 3.0, 
Step 4 


Input Processing 


NIPLOAD 


NVIFDCBSN —_ 1 Create BLDL list. Ca BLDL 


= ie 
| 
— _| BLDL 
error 4 


Output 


Register 1 


Address of module name 








2 Set attributes. 





3 Load specified module. 


LOAD 


Return to caller 





4 Initialize wait state PSW and notify 
operator of error. 





NIPWTO 


NIPSWAIT 
X'32" or X'33' 
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iagram 3.1 NIPLOAD 


ec cs cs ee ee es ce ce ee ee a ee ee se a es = oe 


4. If the module was not found by { 
BLDL, the NIPWTO subroutine is | 
entered to issue the message IEA3-| 
01I module NOT FOUND IN dsn. If | 
an 1/0 error occurred during BLDL | 
processing, NIPWTO issues the mes-| 
Sage IEA300I I/O ERROR DURING BLDL| 
FOR module IN dsn. In koth cases, | 
the NIPSWAIT subroutine is entered| 
to place the system in a disabled 
wait state (X'32' or X‘33'). 


on 








From SVC SLIH 

for XCTL or type-3 
or type-4 SVC 
request, 


Input Processing 











XCTL Input NIPSVC and NIPSVCX 


Register 15 
Address of entry- 
point name 


Type-3 or type-4 
SVC request input 


Obtain address of requested module 
(NIPSVCX) or build module name 
(NIPSVC), 











Determine whether module was previously Not loaded 
loaded, 






Delete previously loaded module. 





Location X'8A’ 


SVC number 


Load requested module. 


Branch to XCTL or requested SVC routine. 






XCTL or 
SVC routine 


Diagram 3.2: NIPSVC and NIPSVCX 
Provide Linkage to Specified SVC Routine 


DELETE 
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Diagram 3.2 NIPSVC & NIPSVCX (IEAVNIPM) 


(a a ee Sea CS 
| Notes on Processing | Label 
}—---—-~+------------—--~-------+-----------4-------~~~ 
{| 2. The name of a module loaded for a |NPMCDSRH 

| previous XCTL request is retained | 

{ by IEAVNIPM until a subsequent | 

| XCTL is issued. 

| | 

{ 4. | NPMCDSR2 

| | 

) <3 | NPMSVCEX 

Pe a oS PO Sr Fes ee ee Ee Te eR pCa cee See? 


8h 





Input 


Register | 


EBCDIC unit name or ; 
hexadecimal address 


Register 15 (from IOSGEN) 


Register 7 (from IOSGEN) 


Address of UCB 








Diagram 3.3: NIPUCBFN 
Find UCB for Specified Unit 


From NIP processors 


Processing Output 







NIPUCBFN 






1 initialize input register with hexadecimal 
unit address. 





NiPEBCDX 











Convert to hex 





(To 1OSGEN) 
Register 6 
















2 Find UCB. 






IOSGEN 





Register I 


= Address of UCB if 
found 
= 0's if not found 






3 Determine whether UCB was found and 
set output register, 













To caller 
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Diagram 3.3: NIPUCBFN (IEAVNIPM) 


ee ef ee er een eee 1 ee 1 
| Notes on Processing | Label { 
|-------------------+------------------- +---------- { 
{/ 1. If register 1 1s negative, the |NIPUCBFN | 
| register contains the EBCDIC unit | | 
{ name and requires conversion by | | 
| NIPEBCDX to the hexadecimal unit | { 
| address. | | 
| | | 
fe De | NPMUCBLK | 
| | | 
[Bie |NPMHVUCB | 
a ca Ag Ae me ES sane ee ee freee ee J 


OS 





Input 


Register 1 


N 


N 


VTFLNCK 


VTITOD 


From NIPWTO 
and NIP 


processors 





Processing 


NIPTIME 


1 Determine function requested (Step 2 or 3). 


Response timing from teleprocessing console 


(TOD clock inoperative and binary request). 


Determine current value of TOD clock, 


Binary request: compute time relative to 
first entry to IEAVNIPM. 


Decimal request: compute time elapsed 
since start of day. 


Indicate clock inoperative; notify operator 
of error. 


Not operative 


Ee 6 


Diagram 3.4: NIPTIME 
Determine Absolute Time or Relative 
Time Since IEAVNIPM was Entered 


Register 1] 


Return to 
caller 


Register ] 


Relative time 


Return to 


caller F 
Register | 


Elapsed day time 


Return to 
caller 


Ee 
NVTFLNCK 
Bese 

NIPSWAIT 

X'35' 
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Diagram 3.4: NIPTIME (IEAVNIPM) 
Pee ee Fe Renee bg ee a, ee Oe gee ee as tt ws i ae i oO 


is 


| 
r 


Cc 


Notes on Processing | Label 


1. A request code X‘'O4' indicates a 
binary request for time relative 
to first entry to IEAVNIPM. 
However, if the TOD clock has been| 
previously indicated as inopera- | 
tive, this is a request from NIPW-| 
TO to time teleprocessing response| 
in writing messages prior toa 
System wait state. The entry 
number is (n+1)/10000. 


~-------=------------------------------ $----------4 
| 
| 
| 


3. A Store Clock instruction is 
issued to determine the value of 
the TOD clock. 
5. A decimal request is indicated by |NIPTOP 
X‘'O00" in register 1. 
| 
6. NIPTIME uses the NIPWTO subroutine|NIPTDEC 


to issue the message IEA302I TOD | 
CLOCK INOPERATIVE and passes con- | 
trol to NIPSWAIT to place the sys-| 
tem in a disabled wait state 
(x'35'). | 

L 


cS 


Diagram 4.0: IEAVNPO1 
Initialize System Consoles 


From Diagram 3.0, 


Input Step 4 Processing Output 
(To NIPUCBFN) 






TEAVNPOT 








Register | 


EBCDIC unit address 


Register 3 


Address of CVT Sa) SS Se 1 Find UCB for console. NIPUCBEN 


DPT OS . 3.3 


CVTCUCB f eae 






UCMUCB 


2 Determine cansole 





| ml —_=— come 
availability . NPITESTC 
Rt Ain ty | Console offline 
UCMMCSPT { 
UCMMCENT | 
UCMUCB 
UCMVEA | 3 Initialize active console. NPITINIT 
UCB (from NPITESTC) | 4.1 
SRTESTA -——_—— _ 
Bie ee he 
a re 
UCMALTEN ——_—— OS 4 Determine whether al! UCM entries 
have been examined; get All not examined 
ere area next entry if not. aD | 
Bias) Ss) 
5 Determine whether master Found 
console has been found. IEAVNIPM 
Diagram 3.0, 
Step 5 
Not found 
NIPSWAIT 
X'07' 
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Diagram 4.0: IEAVNPO1 


r--- 


| 


| Notes on Processing | Label 


t 
The initialization of consoles is | 
performed in a loop, always begin-| 
ning with the master console spe- | 
cified at system generation, then | 
the alternates to the master con- | 
sole, and finally the other con- | 
soles represented in the UCM not | 
yet tested, beginning with UCMVEA.| 

| 


The subroutine NPITESTC executes a|NP1ITESTC 
channel program to the specified | 
console and indicates the results | 
in SRTESTAT. | 
| 
The subroutine NPIINIT flags the |NP1INIT 
console as active. If the master | 
console has not been initialized, | 
the routing and authorization | 
codes and the UCM master pointers | 
are set, and initial operator com-| 
munications are established (see | 
Diagram 4.1). | 


If more than one console is online|NP1CMNT 
or if the single console is graph-| 

ic, HARDCPY is required (referred | 

to by LEAVNPO7). 


nS 


Diagram 4.1: NP1INIT and NP1TCOMM 
Establish Operator Communications 


From Diagram 4.0, . 
a ig Processing Output 


NPIINIT and NPITCOMM 


1 Initialize console UCB. ol UCBSTAT 


Initialized TEAVNPO] 


2 Determine whether master console has 


already been initialized. Diagram 4.0, 
Step 4 


3 Initialize master console . a SS ie I NCE eS “— 
aes 


| GETMAIN | 


NIPWTOR 


4 Obtain message reply buffer; build 
and issue message IEAIOIA. 





NVTMBUF 





NVTMBEND 
peat em IEAVNPO| | NVTMBEND | 
NPITESTC Diagram 4.0, Peet ond 

Step 4 
5 Determine whether WTOR ECB has been Not posted 
Bete NPITESTC 





6 Move reply into message buffer, NIPWTOR2 


7 Determine whether more parometers are to 


be entered by operator. NPITESTC 


8 Issue message IEATI6A. me NIPWTOR 


NPITESTC 


No more parameters 
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ijagram 4.1: NP1INIT & NP1TCOMM (IEAVNPO 
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Notes on Processing | 
Establishing communications with | 
the console operator is a two-part| 
process in which the operator is_ | 
requested to specify system para- 
meters (NPLIINIT) and the reply is 
moved into a message kLuffer for 
later processing by IEAVNPO3. 


| 
| 
| 
| 
| 
1. Both halves of a composite console| 
are initialized before proceeding | 
with Step 2. | 

| 

3. If the active master console is | 
not the console specified during | 
system generation, the routing and| 
authorization codes are moved to | 

the UCM for the new active master | 

| 

| 


console, and the UCM prefix is 
updated. 


| 

4. A 2K reply buffer is obtained fror| 
subpool 255 of the SQA. | 
This buffer is deleted by IEECMWTL| 
after NIP execution. 


7. Additional parameters are indi- 
cated by the characters ‘CONT* 
followed by a quotation mark at 
the end of the parameter string. 
A quotation mark following anyth- 
ing but ‘CONT’ indicates the end 
of the parameter string. 


8. The reply to this message is pro- 
cessed in the same way as the 
reply to IEA101A. 


oe ee ee oe 2 ww © © ee © oe a we © 2 2 2 ee ee a es oe oe ee 


a es 
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NP1INIT 


NP1ACT 


NP1TCOMM 


NP1COMM 


NP1SCAN 


9S 


Input 





From Diagram 3.0, 
Step 4 


CVTILK2 
CVTSY SAD 
CVTDCBA 


CVTSVDCB 
CVTLINK 


Eon 
» D> > 


4 


ee 
NVTNUCN 


ORT ew 4 oe 
hare eer SRS 


Tapa 





Processing 


IEAVNPO2 


1 


Initialize the unit test DEB tn 


IEAVNPO2. 


Test availability of devices. 


Define SYS1.LOGREC DEB base tn nucleus 
and open SYS1.LOGREC data set. 


Define SYS1.SVCLIB DEB base in nucleus 
and open SYS1.SVCLIB data set. 


Define temporary SYS1.LINKLIB DEB in 


nucleus. 


Indicate SYS1,SVCLIB and SYS1.LOGREC 


data sets available for system use. 








Diagram 5.0: IEAVNPO2 
Contro! Routine 


Output 


ea 
DEBAPPAD 
DEBENDCC 
DEBEN DHH 
DEBEXSCL 
DEBSTRCC 


DEBST RHH 


NP2RRCD3 
Test DASDs 


NP2EXCPU 
Test non-DASD 


devices 


DEBUCBAD 


2a aes 8 


NIPOPEN 


NIPOPEN 


NP2BDEB 


ee es NVTFLSLB 





{EAVNIPM 
Diagram 3.0, 
Step 4 
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Direct Access Device Class 
Unit Check Unit I/O 
Unit SIO/TIO (Intervention Check Error Normal I/0 
Type cc=3 Required) (Other) (Other) Status 
2301 Offline Offline Offline+ Offline*+ Cnline/Ready 
2305 Offline Offline Offline+ Offline+ Online/Ready 
2314 Offline Not Ready* Offline+ Offlinet Cnline/Ready 
2319 Offline Not Ready* Offline Offlinet+ Online/Ready 
3330 offline Not Ready* Offline+ Offline+ Cnline/Ready 
(Other) Offline Not Ready Offline offlinet Cnline/Ready 
*Offline status is set if the DEVSTAT option was selected 
during system generation. 
4An interpretive error message identifies the device status. 
Magnetic Tape Device Class 
Unit Check Unit Check 
SIO/TIO (Intervention (Intervention 
Unit Type cc=3 Required) Required) Other 
With Status "A" With Status "A" 
and "B”" off and/or "B"™ on 
2400 
3400 
2420 Offline Offline NotReady Cnline/Ready 
(Other) Offline Offline Not Ready Cnline/Ready 
Unit Record, Communications, and Graphics Device Classes 
SIO/TIO 
Unit Type cc=3 Other 
All Offline Online/Ready 


ee ce ee ee ee ee we ee ee i ew wt we we es ww ew ws en we eg we we 


ee eee | 


Diagram 5.0: 


IEAVNPO2 
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IEAVNPO2 contains the DEB used for| 
testing devices. It is defined to| 
reflect a maximum data set size of| 
X'7JEFF* tracks extending from CCHH| 
0 to X'FFFFFFFF.' | 


Each UCB in the UCB address table 
that has not been examined by | 
IEAVNPO1 is tested to determine | 
the status of the associated | 
device. For direct access [ 
devices, the subroutine NP2RRCD3 | 
builds a channel program to read | 
the volume label. For nondirect (| 
access devices, a NOP CCW is spe— | 
cified. The subroutine NP2EXCPU | 
executes the channel program. The| 
Subroutine NP2TERR is entered fol-| 
lowing all non-DASD I/O orferations| 
and from NP2RRCD3 for failing DASD| 
I/C. For a failing I/O operation, | 
the UCB is set to indicate that | 
the device is offline. A UCB for | 
a DASD is set to indicate that the| 
device is not ready. This fpro- | 
cessing occurs in a loop for each | 
untested ECB in the UCB address | 
takle. Device availability test- | 
ing is described in the adjoining | 
takle. | 


IEAVNPO2 passes the address of the|NP2DDEFS 


system residence UCB (CVTSYSAD) | 
and the address of the SYS1.LOGREC| 
DCB (CVTDCBA) to NIPOPEN. 


The address of the SYS1.SVCLIEB DCB 
(CVTSVDCEB) is passed to NIPOPEN. 


The address of the SYS1.LINKLIB 
DCB (CVTLINK) is fassed to 
NIPOPEN. 


—————— 


| 
| NP2SEARC 


IEAVNPO2 


NP2NDASD 


8S 


Input 
Register | 


Address of parameter 
list 


Parameter list 


[Dataset name 


VOLSER or UCB 
address 


From NIP 
processors 





Processing 
NIPMOUNT 

4 Determine whether UCB address or VOLSER 
was passed in parameter list. 

2 Determine whether volume is already 
mounted , 

3 Request operator to specify unit address 
on which volume is to be mounted. 

4 Find UCB for operator-specified device. 

5 Request operator to mount volume on 
specified device. 

6 Test device availability. 


UCB address 


> 5 


Already mounted 


NP2RRCD3 


Not ready 





Diagram 5.1: NIPMOUNT 
Mount Specified Volume on Specified Device 


Return 
to caller 


NIPWTOR 
1EAVNIPM 
subroutine 


NEPUCBFN 


IEAVNIPM 
subroutine 





IEAVNIPM 


subroutine 





Return 
to caller 
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Diagram 5.1: 


| Notes on Processing 


i a ee ee ee eee ae 
Wd 
6 


IEAVNPA2 (IEAVNPO2) 


| LEAVNPA 2 


| 
The NP2VSCAN usbroutine compares |NPA2VOL 
the volume serial passed with each| 
entry in the UCB address table. { 
If a duplicate volume serial spe- | 
cification is found, NP2VSCAN | 
returns the address of the duplic-| 
ate UCB address table entry. If | 
no device type iS specified in the| 
parameter list or if the UCB found| 
by NP2VSCAN is for the specified | 
device type, the volume is consi- | 
dered mounted. | 


The operator may be allowed, if so|NPA2SPEC 
specified by the parameter list, | 

to cancel the mount request. If |NPA2EOB 
the request is canceled, | 
NIPMOUNT sets register 1 to 0 and |NPA2INV 
returns control to the caller. If| 

an invalid reply is received, the | 
operator is requested to respecify| 

the unit address. 


ee ee ee ee ee ee ee ee se eee ee ee se ee ee ee eee 


r 
| Notes on Processing 


On 
e 


If the unit is invalid, the orpera-|NPA2UNAC 
tor is requested to respecify the 
unit address. If a UCB was found 
for the specified volume but an | 
unacceptable device type is found | 
ky NP2VSCAN in Step 2, and the | 
volume is permanently resident, | 
and the request cannot be can- | 
celed, the system is put ina dis-| 
abled wait state by NIPSWAIT in | 
IEAVNIPM (X'39'). If the volume | 
is not permanently resident, the | 
UCB found ky NP2VSCAN is marked | 
unavailable by NP2TERR, the UCB | 
found ky NIPUCBFN is marked online| 
and not ready, and the operator iSs| 
requested to mount the volume on (| 
the operator-specified device. | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
1 


| NPA2MNT 


The suktroutine NP2RRCD3 builds a 
channel program to read the volume 
lakel. If the channel program 
executed by NP2EXCPU fails but the 
record was found, the NIPSENSE 
subroutine in IEAVNIPM is entered 
to write an interpretive error 
message. 


A flowchart of this subroutine is 
included in Section 3. 
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Input 


Register 1] 


Address of parameter 
list 


Parameter list 


DCB address 


UCB address 





From NIP Processors 








Diagram 5.2: NIPOPEN 
Open Specified Data Set 


Processing 


NIPOPEN 







Optionally construct 
DEB base. 






| NP2BDEB | 


NP2BXTNT 







Add DEB extent(s) to 
DEB base. 







Return to 
caller 
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Fram Diagram 3.0, 
Step 4 






IEAVN PO3 


C . * 


Diagram 6.0: IEAVNPO3 
Initialize Page Data Sets 


Processing Output 






Analyze and create table from system 
parameters specified by operator. NP3O PSP 


OPERTAB 










Allacate and define initial PARMAREA, NP3PBASE 


NP3PMLIB 
Analyze and create table from system 


parameters specified in IEASYSXX 
6.4 


member of PARMLIB. NP3SY SP 


Merge OPERTAB and PLIBTAB into 


PLIBTAB. NP3PLMRG 


Initialize PARMTAB in PARMAREA, —— NP3PTAB 


| NPSLKLIB 


NP3LCAT 





Open the SYST.PARMLIB data set, 





PLIBTAB 












PARMAREA 











Open SYST.LINKLIB. 






Define SYS1.LINKLIB concatenations. 





JIEAVNIPM 
Diagram 3.0, 
Step 4 
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Diagram 6.1: NP3OPSP 
Check Validity of Operator Parameters 
and Buitid OPERTAB 


From Diagram 6.0, 


Input Step I 


Processing 














NP3OPSP 








| NVTSPE SS Se 1 Determine input parameter list specified a oe TEAVNPOS 
Step 2 











Parameters 






Invalid 









= == Scan operator input for valid parameters, NIPVTOR O 
| utput 
| IEAVNIPM 
Subroutine 4 
OPERTAB 





Move addresses of valid parameters into 
OPERTAB, 







IEAVNPQ3 
Diagram 6.0, 
Step 2 





Add new SPE to chain for new operator 
reply. 
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Diagram 6.1: NP3O0PSP (IEAVNPO3) 


Notes on Processing 


N) 
a 


ies) 
e 


£ 
r 


If the first operator-specified [ 
parameter is “U" or "U,L™ the sys-| 
tem parameter list IEASYSOO is { 
selected as the source for all 
parameter input. 


| 
| 
IEAVNP03 uses two tables within | 
IEAVNP03 to verify the parameters. | 
TRANSTAB contains an index value | 
for each character which may | 
validly begin a parameter specifi-| 
cation. This index value is used | 
as a displacement into SYMBSTRT. | 
SYMBSTRT contains all of the valid| 
parameters that may be specified | 
by the operator. Each parameter | 
entry is in character format and | 
is followed by a hexadecimal con- | 
stant indicating the number of | 
valid characters (including the 
equal sign where necessary) in the] 
parameter. The value from TRANS- | 
TAB indicates the position within | 
SYMBSTRT where the comparison of _ | 
the operator-specified parameter | 
with valid parameters begins. | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
L 


The operator is notified of 
errors, and is allowed to respec- 
ify invalid parameters. 


The TRANSTAB index value is used 
as the displacement into OPERTAB 
at which the address of the para- 
meter is stored. 


An eight-byte SPE is added to the 
chain of SPEs that contain 
Operator-specified parameters. 
The address of the operator reply 
(to respecify or cancel} is moved 
into the new SPE. 


NP30OPSP 


NP 3SCAN 


NP3OPRES 


NP3ENTER 


NP3GETMN 


ng 





From Diagram 6.0, 
Step 2 





Diagram 6.2: NP3PBASE 
Allocate and Initialize PARMAREA 


Processing 






NP3PBASE 






Output 














1. Allocate 2K buffer for PARMAREA, 









GETMAIN 






NVT 
NVTPARE 

a aoe ee 
EE 







PARMAREA 





2 Initialize BLDL header, [OB, DCB, 
and DEB in PARMAREA, 










IEAVNPO3 
Diagram 6.0, 
Step 3 
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Diagram 6.2: NP3PBASE (IEAVNPO3) 
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| Notes on Processing 


| 1. The PARMAREA will contain the 

| operator~-specified parameters 

| pointed to by OPERTAB and the 

| parameters specified via SYSP and 
[ pointed to by PLIBTAB. These 

| parameters will be merged by 

| NP3 PLMRG. 


99 









Diagram 6.3: NP3PMLIB 
Open SYS1.PARMLIB Data Set 


From Diagram 6.0, 


Step 3 Processing 
NP3PMLIB 
1. Find the SYS1.PARMLIB data set, : LOCATE. 


Not found 
4 
2 Ensure that volume is mounted, and 


set UCB address. ame _NiPOUNT J Output 









3.1 


PR Rt 
NVTSPUCB 





3 Open SYS1.PARMLIB data set, NIPOPEN 


IEAVNPOS3 
Diogram 6.0, 
Step 4 


input 

















es Sp Toc. oh. 
CVTSYSA ape a — — — Hd Use IPL volume as default, and set bene oe Ris 
yee Te ied A! UCB address, Se NVTSPUCB 


Ley s 








(= -=S24S >>> SS Se Se a a ee 1 
| aaTaWaean | “ty | 
| | 

| alrind¢edn | “rT | 
}---------- 4$--------------------------------------- ’ 
} Teqey | Hutssas0i1g UO sa jon | 
ae one eee oe Se em ae er EN On REAL) ee ere green ee ere ee Pee J 
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Methced cf Operation 


Section 2: 


89 


Diagram 6.4: NP3SYSP 
Build the PLIBTAB 


From Diagram 6.0, 


Step 4 Processing 


NP3SY SP 


1 Allocate 2K area for parameter input, j GETMAIN 


2 Read PDS (partitioned data set) for 
JEASYSXX, NIPPMPDS 


3 Read text record of IEASYSXX, NIPPMTXT 


4 Move characters in text into secondary 
PARMAREA, 


Output 


iar (ey eee Oe 
6 Set OPI indicators for all parameters i 


entered in this list. 


No 
7 All parameter lists processed ? ao 


Yes 


5 Scan parameters and move addresses of 
valid parameters into PLIBTAB. NP3SCAN 





IEAVNPO3 
Diagram 6.0, 
Step 5 
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Diagram 6.4: NP3SYSP (IEAVNPO3) 


rr ee a ne Se oe 1 
Notes On Processing | Label 


—_—_—_—ee eee ee ee ee ee ea ee en eee 


—<— ee ee ee ee ee ee ee ee ee ee es ee ees ee es ee ee ee ie a ee a ee ee 


The secondary PARMAREA is used as |NP3SYSP 
a buffer to contain all of the | 

input parameters from IEASYSxx 

members of SYS1.PARMLIB. 


| 
| 
| 
IEASYSOO is always read first. [ 
Steps 2 through 6 are executed in | 
a loop for the specified input | 
strings. [ 
| 
The text of the input string is | NP3SYTXT 
read into an 80-byte buffer bya | 
channel program within the initial| 
PARMAREA. | 
| 
The text is moved, one character |NP3MOVST 
at a time, into the secondary | 
buffer. An additional secondary | 
buffer is obtained if the present | 
buffer becomes filled. 
| 
The subroutine NP3SCAN moves the’ |NP3SYSFT 
addresses of the valid parameters | 
into the PLIBTAB within IEAVNPO3. | 
If duplicate specifications are [ 
encountered, the PLIBTAB entry for| 
the duplicate parameter contains | 
the address of the last-examined | 
specification for that entry. | 
L 


OL 





Diagram 6.5: NP4PTAB 
Move Parameters into PARMAREA; 
Set FARMTAB Address 
From Diagram 6.0, 


Step 6 Processing 







NP4PTAB 


Output 





Remove secondary PARMAREAs from queve 
originating with initial PARMAREA, 



















Initial PARMAREA 


Parameters 







Move parameters pointed to by PLIBTAB 
addresses to initial PARMAREA, setting 
PARMTAB addresses for each. 





Set address of PARMTAB. 


NVTPTAB 









Release all secondary PARMAREAs . 





FREEMAIN 


IEAVNPOS 
Diagram 6.0, 
Step 7 
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Diagram 6.5: NP3PTAB (IEAVNPO3) 


1. The secondary PARMAREAS are 
removed so that the initial PAR- 
MAREA can be expanded as neces- 
Sary. The PARMAREAS are chained 
so that any additional PARMAREAsS 
obtained are queued to the last 
PARMAREA obtained. Removing the 
secondary PARMAREAS leaves the 
initial PARMAREA as the last one 
obtained. 


cL 


Diagram 6.6: NP3LCAT 
Concatenate Members with SYS1.LINKLIB 


From Diagram 6.0, wv 
iepee Processing 






NP3LCAT 
1 Read partitioned data set For LNKLSTOO 


in SYS1.PARMLIB. NIPPMPDS 


8 


2 Obtain 2K buffer for member names. | GETMAIN 


3 Read LNKLSTOO member and move names —_ 


from input buffer to work arec. NIPPNTXT 


Not found 


4 Find volume for each name and move 


VOL ID to work area. | = LOCATE 
5 Ensure that the volume is mounted. | = NIPMOUNT | 


6 Concatenate the data set with the =. 


previously defined portion of the 
SYST.LINKLIB. | = NIPOPEN | 


7 Release work area, | ss FREEMAIN | 


IEAVNPO3 
Diagram 6.0, 


Step 8 
8 Inform operator that the LNKLST function 


is inoperative. | NIPWTO | 


IEAVNPO3 
Diagram 6.0, 
Step 8 
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Diagram 6.6: NP3LCAT (IEAVNPO3) 
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4 
| 2. The 2K buffer is assumed to be | NP3LCAT 
| large enough to contain all of the| 
| member names found in LNKLSTOO. { 
| If it is too small, the member 
| name list is truncated following 
| the last name entered in the 2K 
[ buffer. 
| 
| 3. The first byte of the name in the |SCANRCD 
[ work area is a flag byte, the 
[ next 44 bytes are the name of the |NP3LCNAM 
| member, padded to the right with 
| blanks if necessary, and the last 
{ 6 bytes contain the VOL ID. 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


a loop for each member name placed 
in the work area, or until 15 men- 
bers are successfully 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
4. Steps 4 through 6 are executed in |NP3LCLOC 

| 
| 
| 
concatenated. [ 
| 

| 

| 

| 

| 

L 


TL 


From Di 3.0, Py 
Input sep4 «Processing 
LEAVNPO4 
1 Build page parameter matrix from 
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8 


9 





PARMLIB and operator entries. 


Optionally display parameters. 


Allocate quickstart buffer. 


Build page device table; format page 
data sets; build and write NIPQSR] 
records for these data sets. NP4PDSEL 


Build channel program queue. NP4BCPQ 


Allocate and build page frame table. NP4APFT 


NP4BPFT 


Read NIPQSR2. NP4RQ SR2 


Re-initialize SQA, NP4BSQA , 


Initialize PVT. NP41PVT 


e 
— 





Diagram 7.0: IEAVNPO4 
Open and Format Page Data Sets 


Output 







Page pcrameter matrix 


og 
Ed 


a 


IEAVNIPM 
Diagram 3.0, 
Step 4 
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Diagram 7.0: IEAVNPO4 
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ND 
e 


WwW 
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£_ 
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T 
Notes on Processing | Label 


All entries from the IEASYSxx list|IEAVNPO4 
of SYS1.PARMLIB are scanned [ 
first. Operator-specified entries|NP4&PSCAN 
are entered next, overlaying | 
(if permissible) previoug duplic- |NP4PINV 
ate entries. If no entries are [ 
found in either list, the operator| 
is requested to enter PAGE parame-| 
ters via NIPWTOR. If a format ; 
error is encountered, the PAGE [ 
parameters are truncated with the | 
last valid parameter specifica- { 
tion, and the operator is [ 
requested to respecify the | 
remainder of the PAGE parameters | 
or accept the truncated PAGE [ 
definition. | 
| 
If any parameters are displayed, |NP4PDOPT 
the operator is allowed to respe- | 
cify any of the PAGE parameters. | 


| 
The quickstart buffer is used for |NP4PDEV 
reading and writing the quickstart | 
records (NIPQSR1, NIPQSR2, and | 
NIPQSR3). A NIPQSR1 will be 
created for each data set for- 
matted by NP4YPDSEL (Step 4). 


| 
| 
| 
| 
NP&PDSEL formats only the page [ 
data sets that have not been for- | 
matted during a previous entry to | 
NIP, or that have been | 
respecified. | 

4 


5. The channel program queue is built|NP4YBCFC 
in the high end of the nucleus | 
kuffer and contains ten or more 
skeleton channel frograms. The 
number of channel programs 
(entries) is determined as fol- 
lows: 1 paging device = 10 CPQEs; 
more than one paging device = 15 
CPCEs; plus the number of 
operator-specified CPQEs. 


NPUAPFT 


On 
e 


The area for the page frame table 
is allocated above the channel 
program queue. 


wd 
e 


If the NVTFLOS flag has been set 
by NP4PDSEL, the quickstart Luffer 
is refreshed with NIPQSR1 and 
NIPQSR2 for the LPA rage data Set. 
NIPQSR2 is required by NP4&BSOA 
(Step 8). 


fee] 
e 


NP4BSOQA processes the SQA paramet- |NP4YBSCA 
er. If the redefined SQA size 
would overlap the high LPA 
address, and a quickstart is in 
process, the operator is given the| 
choice of canceling the SQA spfeci-| 
fication or terminating the quick-| 
start process (in which case the | 
NVTFLCS flag is set to 0). 


| 

| 

| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
[NPGRQOSR2 | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| | 
| 

| 

| 

| 
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Input 


Page parameter matrix 








From Diagram 7.0, 


Diagram 7.1: NP4PDSEL 
Initialize Paging Devices 


Step 4 Processing 
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NP4PDSEL 


Build temporary paging device table 
entry and page device information 


table at top of nucleus buffer. NP4IPDT 


Open page data set for device. 


Read NIPQSR1 to determine whether the 


page data set is formatted. | NPA4READ 


Formatted 


Initialize formatting and add formatting 


ECB to WAIT list. NPA4INTF 


| ad 7 


IF NIPQSR1 is for a formatted LPA page 
date set, set quickstart flag. 





NVTFLQS 





Move temporary PDIT to permanent 

PDIT in low nucleus buffer. NP4BPDIT 
When all matrix entries are processed, 

wait for last ECB in list to indicate 


that formatting is completed. mal WAIT 


Build ond write NIPQSRI1 for each data 


set just formatted. mal NPA4WRIT 


Move temporary PDIT to permanent 


PDIT in low nucleus buffer. NP4BPDIT 
Move all active PDT entries to permanent 


PDT in low nucleus buffer. IEAVN PO4 
Diagram 7.0, Step 5 
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| Notes on Processing | Label 
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! 
| 
! 
! 
! 
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| 
! 
i 
! 
1 
| 
( 
t 
' 
! 
i 
! 
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{ 
| 
! 
| 
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The first six steps are executed |NP4PDSEL 
in a loop, processing each page 
data set specified in the PAGE 
parameter matrix created by 
IEAVNPO4S (Step 1). 

NP4YPDSEL verifies the parameter NP4PDTI 
specifications; the operator is 
allowed to respecify invalid 
devices. The PDIT and PDTE for 
the data set are created at the 
upper end of the nucleus because 
the permanent PDIT will contain 
only active entries, and the numb- 
er of these will not be known 
until all data sets have been 
processed. 


If the data set cannot Le found by|NP4POPEN 
NIPOPEN, the NP4ALLOC Subroutine | 
attempts to allocate the page data| 

set. If the data set cannot be 
allocated, the operator is 
requested to respecify the para- 
meter or cancel the specification. 


An NIPQSR1 record exists for each |NP4YROSR1 
data set that has been formatted 
during a previous entry to 
IPL/NIP. 

NP4YBPBAL 
The NVIFLOQS flag is set if NP4YROSR1 


coldstart processing was not spe- 

cified (CLPA parameter) or if the 

“F" parameter was not specified in 
the PAGE parameter. 
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Input 


Register 1 


Address of parameter 
list 


Parameter list 


Address of DCB 





From IEAVNPO4 é 
and 1eAvNPOS «= PrOCessing 


IEAVNPA4 


1 Disable interruptions. 


2 Determine reason for entry and process 
accordingly. 


A. Read/write quickstart record, 


B. Allocate quickstart buffer. 


C. Release quickstart buffer. 


D. Initiate or restart formatting. 


E. Build cylinder count vector. 


F. Initiate coldstart process. 


G. Load module fit. 


H. Complete coldstart process . 


I. Invalid request. 





Diagram 8.0: IEAVNPA4 
Control Routine 


| MODESET 






NPA4READ and 
NPA4WRIT 
Caller 


NPA4G BUF 
Caller 


fos) fo=) 
ND 


NPA4F REE 
Caller 
23 
NPA4INTF and 
NPAARSTF 
Caller 
8.4 
NPA4BC CV 
Caller 
8.5 
NPA4INTC 
NPA4LOAD 
Caller 
3.7 
NPA#CCST 
Caller 
8.8 
NIPSWAIT 
X'3F* 
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Input 








NVT 


NVTQSBUF 


CVT 


CVT XAPG = 


Parameter list 






From Diagram 8.0, 
Step 2 


Processing 


NPA4READ and NPA4WRIT 


Diagram 8.1: NPASREAD and NPA4WRIT 
Read and Write Quickstart Records 


Output 









aS 
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wee fF 

oy 

Pa ? *s 
° rw 


IOBSTART 





Initialize [/O control blocks within IEAVNPA4 


IOBDCBPT 





No record 
specified 


aap 9 


Determine which quickstart record is to 
be read or written, 


Initialize to appropriate I/O buffer 
(buffer 1 = lower 4K for record 2; 
buffer 2 = upper 4K for records | and 3. 


Convert TTR to CCHHR and build channel program 


Execute channel program. 


Wait for 1/O to complete. 


Operation successful: set return code. 


Operation not successful: issue interperpretive 
I/O error message. 


Set error return code. 
















lOBCSW 
oR 
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IECPCNVT 


EXCP 


WAIT 


Parameter List 








{EAVNPA4 
Diagram 8.0, 
Step 3, 










NIPSENSE 


Parameter list 





IEAVNPA4 


Diagram 8.0, 
Step 3 


Diagram 8.1: NPA4READ/NPA4WRIT (CIEAVNPA4) 


ee ee ee ee ee ee ce ee ee ee ee i ee we ws ee ee oe ee ee a w= oe 


1. | NPASRDWR 


| | 
{| 3. The lower buffer (buffer 1) is | NPA4QSR1 
{ pointed to by NVTQSBUF and the [ 

| upper buffer (buffer 2) is equal |NPA4QSR2 
l to buffer 1 plus 4096. NIPQSR2 

[ is read into and written from | NPAYQSR3 
[ buffer 1; NIPQSR1 and NIPQSR3 are 
| read into and written from Ltuffer 
[ 2. because NIPQSR1 contains the 

| TTR Of NIPQSR2 and NIPQSR2 con- 

[ tains the TTR of NIPQSR3, a read 

| or write request for NIPQSR2 or 

[ NIPQSR3 requires ‘that the record 

[ (NIPQSR1 or NIPQSR2, respectively) 
[ that contains the TTR be in the 

[ other buffer. 

l 

[ PA4QsIoO 
l 

| PAS EXIT 
| 

[ NPA4S FAIL 
| 

| 9. Error return codes are: 
| 

[ 

| 

[ 

L 


X*°00° No error 

X°O4" Insufficient space 
X'O08" I/O error 

X*0c" Insufficient DASD 
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From Diagram 8.0, 


Step 2 Processing 







1 Obtain 8192 bytes from subpool 252, | GETMAIN 


2. Enable for interruptions. 


NPA4GBUF 


3 Set return code. 


4 








Issue IEA2 161 message . 


Diagram 8.2: NPA4GBUF 
Obtain Quickstart Buffer 


Output 










Not allocated 
4 
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NVTPAGIO 
NVTQSBUF 
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| MO DESET 


IEAVNPA4 
Diagram 8.0, 
Step 3 
















Parameter list 





NIPWTO 
IEAVNIPM 
subroutine 


NIPSWAIT 
X'38' 
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Diagram 8.2: NPA4GBUF (IEAVNPA4) 


a ee ae a ae 
|Notes on Processing | Lakel ; 
}--------—---------—---------—------—--- $---------- : 
| 1. {|NPAGGBUF | 
| | 
} 2. {NPAGPXIT | 
| | | 
| 3. {[NPAGNXIT | 
| | | 
| 4. {NPAGNCOR | 
Me ee es ee eee Ce eee ee _4 
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From Diagram 8.0, A 
Step 2 Processing 


NPA4FREE 


1 Free quickstart buffer. 


2 Set return code. 


3 > Enable for interruptions. 





FREEMAIN 


MODESET 


IEAVNPA4 
Diagram 8.0, 
Step 3 


Diagram 8.3: NPASFREE 
Free Quickstart Buffer 
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Diagram 8.3: NPA4FREE 
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Diagram 8.4: NPA4INTF and NPA4RSTD 
Initiate or Restart Processing 


From Diagram 8.0, 
Step 2 


Input Processing 






Parameter list 












Find paging device table entry for 


specified DCB. NPA4SFEPDT 


2 Determine e of 
"YP Restart 


sa > 4 


Build channel program. 


Output 


Channel program 
build table 


eal +, ee Pi - 
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Execute channel program. 





Parameter fist 





Set retum code. 





IEAVNPA4 
Diagram 8.0, 
Step 3 
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Diagram 8.4: NPA4INTF/NPAURSTF (IFAVNPA4) 


r 


| a a a rE a ee 


Notes on Processing 


: 
}--------------------------------------- Perens 


This subroutine formats page data 
sets for which IEAVNPO4 did not 
find a NIPQSR1 record or for which 
reformatting is necessary. 


NPA4 INTF 


| 
| 
| 
id 
3. The channel program build table is 
within IEAVNPAS and contains | 
| 
| 
| 
| 


| 
| 
| 
| 
device-dependent information con- | 
cerning the format of the CCW | 
string required to write the 
count, key and data to the paging | 
devices. 
| 
4. The channel program formats one NPASEXCP 
cylinder of the paging device. [ 
5. The return code X‘'0Q4" indicates | NPASAXIT 
that the channel program was too | 
long to fit in the nucleus buffer. |NPASNXIT 
A return code X*00" indicates that| 
the I/O operation was initiated i 
successfully. | 
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Diagram 8.5: NPAS4BCCV 
Determine Number of Available Pages 
From Diogram 8.0, 


Step 2 Processing 












NPA4BCCV 









1. Find paging device table entry 


associated with specified DCB. NPA4F PDT 


as 
l 
| 
[ 



















2 Count number of available pages in 











Step 3 


| - 
[ each cylinder, ewe eee 
| y Sale: 
Pet 
PDTCCVA J I Parameter list 
= = mh rs l Set retum code. 
TER dt IEAVNPA4 
| Diagram 8.0, 
| 
| 
— 
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Diagram 8.5: NPA4BCCV (IEAVNPA4) 


<b > ey ce ce ee a se es ee a a © oe oe oe eee 


- 
| 2. IEAVNPA4S’ uses loops to examine 

| slots and page groups within the 
| cylinder to determine from the 

| auxiliary bit map the number of 
[ available pages. 

l 
| 
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Diagram 8.6: NPA4INTC 
Initialize PVT 


From Diagram 8, 


Step 2 Processing Output 













NPA4INTC 





IEAVNPA4 





1 Save PVT fields that may be modified 
during coldstart process. 





NPAALTH 
NPA4RPCT 
NPAANPDT 







A 













2 Initialize PVT. ty 
PVTNPOTE 
PVTREPCT 
PVTFLAGI 









IEAVNPA4 
Diagram 8.0, 
Step 3 





a | 
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Diagram 8.6: NPA4 INTC (IEAVNPA4S) 


+ 
| 1. The field PVTNPDTE is set to one |NPA4INTC 
| to force all page-outs to go to | 
| the paged set for the link pack | 
| area. The PVIFLAG1 field is set | 
[ to prevent migration during the | 
| coldstart process. [ 
L 
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Diagram 8.7: NPA4LOAD 
Load Specified Module 


From Diagram 8.0, 
Step 2 


Input 


Processing 





















NPA4LOAD 





a= ae A 
CVT PVT 
ee ee 1) Calculate number of pages needed 
rn CVISHRVM for this module. 
Ca 


NVT 


NVTCSLPG 
REN 
PVT 

PVTSQACT 


| ek en - 
eee mise sca Fh 













Calculate number of pages not yet 
paged out. 











Determine whether there are Insufficient 
enough available pages to space 


hold module. > 5 







Calculate new low threshold. 


Set retum code. 





IEAVNPA4 
Diagram 8.0, 
Step 3 
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Diagram 8.7: NPA4LOAD (IEAVNPA4) 


| Notes on Processing | Label 

Mee oe ee Se ee oe ese 
ie Be | NPASLOAD 

| | 

| 3. | NPAYLMO1 

{ 5. A return code of X‘'0C' indicates |{NPA4AXIT 

[ insufficient space for the | 

| module. | NPASNXIT 

a a ac ee hee a ee ee 
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Diagram 8.8: NPA4CCST 
Complete LPA Coldstart Process 


From Di 8.0, : 
so? -«Processing 
NPA4CCST 


Input 4 


Enable interruptions. 


es ee 
te a a 


+ Tt Eye 
eS ati 


Initialize page vector table and force 
poge-out of all modules in link pack area, 


Re-initialize PVT; build and write 
NIPQSR3 records For LPA, 





NPA4WRIT 


Build auxiliary bit map for NIPQSR2 and 
write NIPQSR2, NPA4WRIT 


Set return code. 


IEAVNPA4 
Diagram 8.0, 
Step 3 
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iagram 8.8: NPA4CCST (IEAVNPAS) 
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2. The paging low threshold is set to|NPA4&CC0O1 
the number of page frames 
available. 


The paging supervisor is entered 
by refering to a page that is not 
in real storage. Discovering that 
the low threshold has been reached 
(forced in Step 2), the paging 
Supervisor initiates page 
replacement. 


3. The PVT fields are restored to 
their original condition upon 
entry to the Initiate Coldstart 
subroutine (NPA4INTC). 


NPA4YCCo0 2 


NPA4CCO3 


5. A return code of X‘'08‘ indicates NPA4&CCRS 
I/O error while reading or writing 
of a quickstart record Ly the NPA-|NPA4&FSLT 
4READ or NPA4SWRIT subroutine. A_ | 

return code of X‘'0C‘' indicates 

that no slot was found by the sub- 


| 
| 
routine NPA4FSLT. | 
r 
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Input 


NVTFLQS 


NIPQSR3 


Parameter list 


NIPQSR2 








From Diagram 3.0, 
Step 4 


Processing 


1 


10 


IEAVNPOS 


Determine whether a quickstart has been 
requested, 


Define previously built LPA. 


Fix specified LPA modules in the nucleus. 


Define system BLDL table in the nucleus. 





NP5CSLPA 


Call this subroutine 
if coldstart 


9.2 


NPSQSLPA 


NP5FIX 


NP5BLDLF 


Add specified modules to the pageable LPA. NPSMLPA 


Define pageable system BLDL table. 


Attach or Detach the IEAVNPAS subtask . 


Define LPA directory. 


Initialize type-3 and type-4 SVC table 
entries. 


Release the quickstart 1/O buffer and 
delete IEAVNPA4. 


Oo 
« 
Ww 


NPSBLDLP 


NP5VTCB 


NPSLPDIR 


NP5SVC 


I ra 






Diagram 9.0: IEAVNPO5 
Initialize Link Pack Area and BLDL Table 


NPA4 FREE 
8.3 


IEAVNIPM 
Diagram 3.0, Step 4 
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Diagram 9.0: IEAVNPO5 


1. The NVTFLQOS flag was set Ly | IEAVNPO5 
IEAVNPOW (label NP4&RQSR1) if the | 
LPA page data was previously for- | 
matted and the CLPA parameter was | 
not specified. NP5CSLPA kLuilds | 

| 

| 


the LPA page data set. 


NO 
® 


| 

| 

| 

| 

| 

| 

[ NIPQSR2 contains the start and end|NPSQSTRT 
| virtual addresses of the LPA. 

| NIPQSR3 contains the slot and 

| group numbers for the records 

| within the LPA page data set. 

| 
| 
| 
| 
| 
| 
| 
L 


-_ 
oO 
® 


| 
| 
| 
| 
IEAVNP0O5 uses the IEAPMNIP macro’ |NP5SRLBUF 
instruction to gain access to the | 
NPA4FREE subroutine in IEAVNPA4. | 
Upon return, IEAVNP0O5 issues an | 
Svc 9 (DELETE) instruction to [ 

L 


remove IEAVNPA4&. 
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Input 


Quickstart record 2 


eos 


. The 
CVTSEGB 





CVTPVTP 


From Diagram 9.0, 
Step 2 





Processing 







NPS5QSLPA 


1 = Obtain and clear space for LPA 
page tables, 





2 Using the slot and group numbers from 
quickstart record 3, initialize the page 
table and external page table entries, 


3 Initialize poge device table entries 
and system segment table entries. 








NPSLPAPT 


IEAVNPO5 
Diagram 9.0, 
Step 3 























GETMAIN 


NPA4READ 











Diagram 9.1: NP5QSLPA 
Initialize Table Entries 
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Diagram 9.1: NPS5SQSLPA (IEAVNP05) 


and external page tables with a 
GETMAIN macro instruction specify-| 
ing subpool 255 of the SQA. All | 
page table entries from the begin- 
ning of the page table up to the 
entry for the first page for the 
LPA are set invalid. 


2. The quickstart 3 records are read 
and processed ina loop. Each 
record is processed by the subrou- 
tine NP5LPAPT. 


| 
| 
| 
| 
| 
l 
| 
| 
| 
| 
If the quickstart process cannot | 
continue because an error occurred| 
while reading a quickstart record | 
3 (in Step 2), execution resumes | 
at Step 4 (9.0) for coldstart. | 
| 
| 
l 
| 
| 
| 
| 
| 
4 


3. Auxiliary page records that con- 
tain LPA pages are indicated as 
unavailable. The virtual 
addresses of LPA page tables are 
converted to real addresses and 
the segment table entries are set 
to indicate maximum size. 


+ 
1. Space is obtained for page tables |NP5QSLPA 


NPSPGTE 


NPSRDOSR 


P5SLPDTE 


N 
NP5LPAST 


00T 


Diagram 9.2: NP5CSLPA 
Attach IEAVNPA5 


From Diagram 9.0, . 
Input Sepa: Processing 







NP5CSLPA 


1 






Activate pogeable task (IEAVNPAS). NPSVTCB 


NVTVRECB 


Pa de 
p " 






Open SYS1.LPALIB (LPA module source 
library) . NP5LPLIB 









Indicate pageable task to initiate coldstart. NP5POST 


Optionally initialize fixed LPA and 
fixed system BLDL table. 


NPSBLDLF 


5 Wait until pageable task processing 
is complete. 





IEAVNPO5 
Diogram 9.0, 
Step 5 
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Diagram 9.2: 


NP5SCSLPA (IFAVNPO5) 


Because module IEAVNPA5 performs | 
certain coldstart functions (and | 
other functions common to [ 
coldstart and quickstart), [ 
IEAVNPO5 attaches IEAVNPAS as a [ 
subtask. The interaction between | 
IEAVNPO5 and IEAVNPAS is governed | 
by event control blocks, one for | 
each module. When IEAVNPO5 needs | 
processing by IEAVNPA5S, it posts | 
the pageable ECB (for IEAVNPA5S) | 
and issues a WAIT macro instruc- | 
tion specifying its own ECB (non- | 
pageable). When the required pro-| 
cessing is complete, IEAVNPAS i 
posts the nonpageable ECB and [ 
issues a WAIT macro instruction | 
specifying its pageable ECB. [ 
| 
| 
[ 
| 
| 
| 
| 
| 
| 
L 


The initial interface with IEAVN- 
PA5 iS provided by the subroutine 
NP5VTCB; subsequent interfaces are 
provided by the subroutine 

NP5 POST, 


The SYS1.LPALIB is the source of 
the modules to be loaded into the 
link pack area. 


See Diagram 10.3 for a description| 
of the coldstart processing. | 
IEAVNPO5 is executed asynchronous- | 
ly from IEAVNPAS until Step 5; ( 
IEAVNPAS performs part of the [ 
coldstart process and indicates [ 
that IEAVNP05 can continue its [ 
processing asynchronously. Howev-| 
ex, IEAVNPAS must complete its y 
coldstart processing before sub- | 
routine NP5CSLPA returns control | 
to mainline coding. | 
| 
| 
| 
| 
| 
| 


NPSPOST calls NPSBLMQ which 
returns control to NP5SPOST which 
calls NPSBLMQ again. This loop 
continues until NP5SBLMQ indicates 
the end of the list to NPSPOST. 


The NP5FIX subroutine and its suk-|NP5SFIX 


routine NP5MLPRM loads the speci- | 
fied modules into subpool 251 in | 
the nonpageable region. Both sub-| 
routine functions are optional 
(user requested). 


| 
| 
The NP9§BLDLF subroutine and its [ 
subroutine NP5SBLPRM create the [ 
fixed BLDL table in the nucleus [ 
buffer. [ 
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Diagram 9.3: NP5VTCB 
Load, Attach, and Delete IEAVNPA5 


From Diagram 9.0, 


Step: Processing 


NP5SVTCB 
Deactivate 


pageable task 
1° Determine type of request. 


2 Bring IEAVNPAS into the nonpageable 


region, 


— 


aa 


3 Attach IEAVNPAS as a subtask. 


Input 
4 Initialize the pageable region for 
IEAVNPAS. NP5VREGN 


het Poy OF 
r “ 


b 


NVTRECB -5 Wait for IEAVNPAS to complete its 


ye initial processing. 


ae! 


NPSCSLPA 
Diagram 9.2, Step 2 





6 Indicate pageable task termination. NP5POST 


7 Remove IEAVNPAS. 


| DELETE 


j FREEMAIN 


8B Release pageable subpool 253 storage 
and any control blocks for the pageable 
region. 


NPSVREGN 


WH 


9 Remove pageable TCB from priority and 


subtask queves. IEADQTCB 


i TEAQERA 


IEAVNPO5 
Diagram 9,0, Step 7 
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Diagram 9.3: NPSVTCB (IEAVNPO5) 
Pee Ge ey en PN ne a OE et EG NP eg Wp enn ee as 1 


ee ee 0 "  " 


Notes on Processing | 


2. For a description of the interface| 
provided by NP5VTCB between | 
IEAVNPOS and IEAVNPAS, see 9.2, | 
Notes on Processing, Step 1. Once| 
IFAVNPAS is activated, subsequent 
requests to activate IEAVNPAS are 
ignored. 


HoT 





From Diagram 9.0, 


moe Processing 


NPSLPLIB 


1 Ensure that SYS1.LPALIB is defined in 
the system catalog. 


2 Ensure that the volume is mounted. 


3 Open SYS1.LPALIB. 











LOCATE 
| NIPMOUNT | 
IEAVNPO2 
subroutine 
5.1 


NIPOPEN 


IEAVNPO2 
subroutine 5.2 


IEAVNPOS 
Diagram 9.0, 
Step 3 


Diagram 9.4: NP5LPLIB 
Initialize SYS1.LPALIB 


Output 


“wor 


NVTCSLIB 
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Diagram 9.4: NPSLPLIB (IEAVNPO5) 


pono -- + - + --- -- 5 + - ++ + + + = ++ 
| Notes on Processing | Label { 
a ee ae ee ee ee re 

| 1. {NP5SLPLOC | 
| | 
| 4. The DCB address for SVC1.LPALIB is| | 
| put in NVTCSLIB. | | 
a ae a ne a a ee ape ee ee oe er ee ee ee J 
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Diagram 9.5: NPSMLPA 
Load Specified Modules into LPA 


From Diogram 9,0, . 
ees Processing 












NPSMLPA 


Input 4 Activate pageable task (IEAVNPAS), NP5VTCB 






2 Analyze PARMLIB list and load specified 


modules into LPA, NPSMLPRAA 





NVTVRECB 





NVTVVTCB 





3 Place modules on LPA queve, NP5QLPAQ 






IEAVNPOS 
Diagram 9,0, 
Step 6 
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Diagram 9.5 NP5MLPA (IEAVNPO5) 


| 1. If IEAVNPAS has previously Leen 
| activated, this request is 
| ignored. 


80T 
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NVTVRECB 


TPT eT ar 
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From Diagram 9.0, 
Step 6 















Processing 


NP5BLDLP 


1 


Scan parameter list for valid entry. 


2. Assign temporary area to BLDL table. 


3 Construct system BLDL table. 


Issue BLDL macro instruction. 


Activate pageable task (IEAVNPAS). 


Indicate pageable task to define BLDL 
table, 


NPSPLIST 


NPSBLNAM 


NPSVTCB 







9.3 


| NPSPOST P5POST 





Diagram 9.6: NPSBLDLP 
Include Modules in BLDL Table 
















a mate 





IEAVNPOS5 
Diagram 9.0, 
Step 7 
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Input 


Register 1] 


Address of parameter 
list 


Parameter list 


MSA 


Se A es 


r re. 
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ECBCCCNT 








From Diagram 9.0 
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Diagram 10.0: [EAVNPAS5 
Control Routine 


Processing 


IEAVNPAS 


\llocate real storage. GETMAIN 


Initialize save area for BLDL entry. 


Post nonpageable ECB to indicate phase 
complete. 


NPASP OST 


Wait for IEAVINPO5 to request more 


work, eo | WAIT | 


NPA5MLPA 
Diagram 10.1 





Determine type of request and process 
accordingly. 


A. Add modules to qu ckstart LPA. 


B. Allocate pageable storage for 


= NPA5BL DL 
system BLDL table. Diagram 10.2 
NPASCLPA 
C. LPA coldstart processing. Diagram 10.3 
NPAS5T ERM 


. i ke 
D. Terminate pageable tas Diagram 10.4 


NIPSWAIT 
X'3F! 


E. Invalid request. 
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Diagram 10.0: IEAVNPA5S 


had 
e 


£ 
e 


Wi 
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All of the region is allocated 
from subpool 252. Sixty-four 
bytes are allocated from sukpool 
255 for the BLDL save area. 


The nonpageable ECB is posted to 


indicate completion of the initia- 
lization process in IEAVNPAS. The 
POSTCD field is set by the subrou- 


tine that performed the 
processing. 


The pageable ECB is specified in 
the WAIT macro instruction. 


IEAVNPO5 posts this ECB when addi- 


tional work is required. 


The type of request is indicated 
by a bit pattern in the pageable 
ECB. Steps 1 through 4 are 
executed only on the first entry 
to IEAVNPAS. Subsequent entries 
are to Step 5. 


| NPASINIT 


pe me ee ee ee ee ee 


NPASSYNC 


ZTL 





From Diagram 10.0, 





Diagram 10.1: NPASMLPA 
Load Specified Modules into LPA 


Processing 














NPASMLPA 


4 > Determine load address for module. 


2 Indicate nonpageable task to continue. 


3 Load module into link pack area. 


Non-pageable ECB 





4 Set return code. 





JEAVNPOS 
Diagram 9.0, 
Step 3 
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Diagram 10.1: NPASMLPA (IEAVNPAS) 


gC nm a ho age a 
| Notes on Processing | Lakel | 
|--------------~-~-~---------------~------}4-----+----- 
[| 1. NPASMLPA is entered from the [|NPASMLPA | 
[ NPSMLPRM subroutine in IEAVNPO5. | | 
| | | 
| 4. Return is via the WAIT/POST |NPA5MSER_ | 
{ interface. | | 
| |NPASMXIT | 
De ee es a ea ee ee EO eee eee J 


HTT 








Diagram 10.2: NPA5BLDL 
Allocate Storage for, 
and Move, BLDL Table 


From Diagram 10.0, . 
Step 5 Processing 







NPASBLDL 


1 Determine size of BLDL table. 










2 Determine location to be occupied by the 


BLDL table. NPASADDR 


Storage unavailable 





Input 






4 

















" "> . 
mney 
a +4 


CVTSHRVM 


oe "rt Ra 
ae ~ a: 






3 Move BLDL table to pageable area. 





NVTBLDL 








Non-pageable ECB 





4 Set return code, 






IEAVNPO5 
Diagram 9.0, 
Step 6 
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Diagram 10.2: NPASBLDL (IEAVNPAS) 


| Notes on Processing | Label 
}----------------——--—--------------------4---------- 
| 1. NPASBLDL is entered from the | NPASBLDL 

H NPSBLDLP suborutine in IEAVNPO5. | 

; | 

| 4. The return code X'O4" indicates | NPA5 BS ER 

{ storage waS unavailable. xX*‘0c‘ { 

| indicates end of normal | NPA5 BXIT 

| processing. | 

"espe ON an Re er OR SAT OP ee ae eae geared ey ee OY 
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Diagram 10.3: NPA5CLPA 
Coldstart Process; Build LPA 


From Diagram 10.0, Processing 


Step 5 
NPAS5CLPA 
Output 
Input 1 Indicate coldstart is being initiated. j NPA4INTC p 
8.6 
ees Oapcare 
NVTCSLIB 2 Initialize [OB for LPALIB,. C—O 


Construct BLDL information table and 


determine hash value. NPASCLIN 





DEBSTRCC 


4 Load modules specified by LPA packing 
list. NPA5SLG RP 





5 Load independent modules. NPASLIND 


6 Construct LPDEs for all module aliases. NPASALIS 


7 Build permanent link pack area directory. NPASBDIR 


8 Complete LPA coldsta:t process. NPA4CCST 
8.8 


IEAVNPOS 
Diagram 9.0, 
Step 5 
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Diagram 10.3: NPASCLPA (IEAVNPAS) 


eC — i aw = Se a ee Oe 


- 
Notes on Processing | Label 
1. NPASCLPA is entered at the request|NPASCLPA 
of the NPSCSLPA subroutine in | 
IEAVNPO5. 


| 
2- The IOB is within IEAVNPAS and is | 
used for the I/O operations that | 
read the SYS1.LPALIB directory | 
records. | 

L 


oe es i a a a ee i 2 ss we ome ee ale a ee ee ee ee ee 
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From Diagram 10.0, 


Step 5 Processing 
NPAS5TERM 
Input r-- 1. Release allocated BLDL entry, save area, 
I 
[ 
I 
I 
4 


BLDLSAV -Tt-- 
2 Set Return code. 





FREEMAIN 


NPSVTCB 
Diagram 9.3, 
Step 7 


Diagram 10.4: NPASTERM 
Release BLDL Save Area 


Output 


Non-pageable ECB 
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jiagram 10.4: NPASTERM (IEAVNPAS) 


Notes on Processing 

1. The V=V space allocated by Step 1 
in IEAVNPAS-0 will ke released by 
IEAVNPOS5. 


2. NPASTERM relinquishes control by 
setting the return code to 
IEAVNPO5S as X‘'0C‘ and by posting 
the V=R ECB. 


+ 
| NPASTERM 


O2T 


Diagram 10.5: NPASLGRP 
Load Groups of Modules Specified 
by LPA Packing List 


From Diagram 10.3, . 
olen Processing 










NPASLG RP 


1 Request list of modules to be loaded. 





NPASPO ST 


Requests 
IEAVNPOS 
Build a list. 










Finished 


2 Determine whether list is finished. > 5 








3 Load specified modules. NPA5SGLOD 


Loop back to Step 1. 





Indicate IEAVNPO5 can continue 


execution, NPA5POST 


NPASCLPA 
Diagram 10.3, 
Step 5 
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Diagram 10.5: NPASLGRP (IEAVNPAS) 


| Notes on Processing 

Pee Sew seas eee See ee 

1. NPA5SLGRP issues a Wait while 
awaiting return from NPA5POST. 


2. Determined by return code issued 


by NPAS5POST. 
a ee ee i a ee eee 


Zot 


From Diagram 3.0, 


Shed Processing 


JEAVNPO6 


1 Initialize DSS (dynamic support system). 


Initialize SY¥S1,DUMP., 


Initialize RMS (recovery management 
support). 


Initialize trace function. 








| Diagram 11.0: IEAVNPO6 
Initialize Reliability and 
Serviceability Features 


NP6éDSS 


NP&DUMP 


11.2 


NP6RMS 


IEAVNIPM 
Diagram 3.0, 
Step 4 


nét 


| Diagram 11.1: NP6DSS 
Initialize DSS (Dynamic Support System) 


From Diagram 11.0, 


Input Step 1 Processing 


NP6éDSS 


CVTDSSV 1 Find and mount SYS1.DSSVM 


data set, eal LOCATE 


ee Output 

















DSVPDSVC 
2 Open SYS1.DSSVM ed 
data set. a NIPOPEN 
DSVPDSST 
30 Find DSS initialization eee 
module (IQAINIOO) . NP6LPAFN DSVPDSEN 


Register 1 = address of 
IQAINIOO 


4G Put address of IQAINIOO 


Register | 


ae in DSS PRB. aS A a IT rN XRBPSW 
DS VDSTCB 
IEAVNPO6 
Diagrom 11.0, 
Step 2 


oO 

WN 

n 

a) 
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| Diagram 11.1: NP6DSS (IEAVNP06) 
De Nee ee re neg t Or ee Pe ee eae MOE ENE, eae cigs eg ee ee oe Get ote 1 


Notes on Processing | 


1. If the data set is not found, the 
beginning and ending CCHH fields 
in the DSS vector table (IQADSV) 
are set to all F's. NP6DSS calls 
NIPWTO to write the messages LOC- 
ATE FAILED FOR SYS1.DSSVM and DSS 
INOPERATIVE to the operator. 
CVTDSSV is the CVT pointer used to 
locate the DSS vector table. 


N) 
a 


+ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 

If NP6DSS cannot open the data | 

set, the beginning and ending CCHH| 

fields in the DSS vector takle | 

(IQADSV) are set to all F's. | 

NP6DSS calls NIPWTO to write the | 

message DSS INOPERATIVE to the | 

operator. | 
| 
| 
| 
| 
| 
| 
| 
| 
| 


WwW 
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NP6LPAFN calls IEAQCDSR to search 
the LPA active queue for IQAINIOO. 
If IQAINIOO is not found, it then 
calls IEAVVMSR to search the LPA 
directory for IQAINIOO. If 
IQAINIOO is found, NP6LPAFN sets 
register 1 to the address of 
IQAINIOO from the CDE or LPDE. 


| 
If the module is not found, NP6DSS| 
calls NIPWTO to write the message | 
IQAINIOO NOT FOUND IN LPA to the | 
operator. NP6DSS puts the address| 
of the DSS Mask Out routine | 
(IQAPFXRT) in the restart new PSW.| 


4. Register 1 contains the address of| 
IQAINIOO. DSVDSTCB iS a fointer 
to the DSS TCB. 


NP6 DSER3 


9ZT 





From Diagram 11.0, 
Step 2 


Input Processing 


NP&DUMP 
If direct 


NVTPTAB -—----oOO 1 Determine SYS1.DUMP device type access 


(tape or direct access), 


2 lf tape, find UCB for unit specified. 


3 Ensure that a non-labeled, non-file- 
protected scratch tape is mounted and 
ready. 


4G Open SY$1.DUMP on tape. 


5 if direct access, find SY$1.DUMP 
data set. 


6 Mount SYS1.DUMP data set. 


7 Open SYS1. DUMP data set. 


(Continued at Step 8) 


Diagram 11.2 (1 of 2): NP6DMP 
Initialize S¥YS1.DUMP 


| NIPUCBEN | ICBFN 


| NIPMOUNT | | NIPMOUNT | 


| NIPOPEN | 


IEAVNPO6 
Diagram 11.0, 
Step 4 


| LOCATE 


| NIPMOUNT | 


| NIPOPEN | 
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Diagram 11.2: NP6DMP (IEAVNP06) 
[| Notes on Processing tst—~—tS i 
oie upeue certs s cnavcer tries cee | 
DUMP parameter. 
If the parameter is not specified 


or iS not valid, NP6DMP checks 
whether there is enough space in 
the nucleus buffer for a DCB for 
SYS1.DUMP. If there is enough 
Space, the operator is prompted to 
Specify the DUMP parameter or can- 
cel the specification. If he can- 
cels, SYS1.DUMP is disabled by 
setting the pointer to the DCB 
(CVTDAR) to 0 and NVTNUCND to its 
value on entry to NP6DMP. Control 
goes to Diagram 11.1, Step 4. 


If there is not enough space for 
the DCB, the operator is notified, 
and SYS1.DUMP is disabled as 
above. 


If DUMP=NO is specified, SYS1.DUMP 
is disabled as akove. If DUMP=NO 
is not specified, NP6DMP checks 
whether there is enough space for 
the SYS1.DUMP DCB. If there is 
not, the operator is notified, and 
SYS1.DUMP is disabled as above. 


e 


NP6DMP also checks the validity o 
the unit address parameter. If i 
is invalid, NP6DMP notifies the 
operator via NIPWTOR and prompts 
him to respecify the parameter. 


—— De ee ee ee ee ee ee 2 ee ee > 2 > ee ee ee ee 


ct Fh 
pre cr a 


emo = a a ee ee i ee ae ce ee oe 


Label 


NP6 DMP 


NP6DMP2 


NP6DUMP 2 


NP6DMP1 


NP6INVLD 
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On return of control from 
NIPUCBFN, the UCR is checked to 
ensure that the device specified 
is a 2400-compatible tape drive 
and is online. 


| NP6DMPTA 


| 
| 
| 
| 
If the device is not 2400- |NP6UNACC 
compatible and online, or if NIP- | 
MOUNT was unable to have the | 
required tape mounted, the opera- | 
tor is notified that this device | 
is unacceptable and is prompted to| 
respecify or cancel the parameter. | 

| 
If the OPEN operation is unsuc- | NP6 NODMF 
cessful, SYS1.DUMP is disabled as | 
in Step 1. 

| 


If the data set is not found, the |NP6LOCNG 
operator is notified with the LOC-| 
ATE FAILED message and is prompted | 
to respecify the CUMP parameter. | 


| 
If the volume containing the data | 
set cannot be mounted, the opera- | 
tor is prompted to respecify the | 
DUMP parameter. | 

4 


er ce es es ee ee ee ee ee ee 8 ee oh 


8ZT 





Processing 








8 Read first record of data set. NP&EXCP 


9 Determine status of dump data set 
(contains dump or empty). 


IEAVNPO6 
Diogrom 11.0, 
Step 4 


SCRATCH 


If size of data set is adequate 





11 If size is inadequate, scratch this 
SYS1.DUMP data set. 














Allocate new SYS1.DUMP of proper 
size, 


Open new SYS1,DUMP data 


set, 






NIPOPEN 





Write an EOF as the first 


record, NPGEXCP 


IEAVNPO6 
Diagram 11.0, 
Step 4 


Diagram 11.2 (2 of 2): NP6DMP 
initialize SYS1.DUMP 
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Diagram 11.2: NP6DMP (IEAVNP06) 


(Cont'd) 


| Notes on Processing 


cc ee ee ee 


io?) 
e 


vs) 
a 
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© 
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If OPEN processing fails because 
the data set is not found, an 
attempt is made to allocate and 
ofen a new data set. 
cessing fails because of insuffi- 
cient storage, SYS1.DUMP is dis- 
abled as in Step 1. If OPEN pro- 
cesSing fails for any other 
reason, the operator iS prompted 
to respecify the parameter. 


If there is an I/O error, NP6DMP 
informs the operator and prompts 
him to respecify or cancel the 
DUMP parameter. 


If the data set contains a dump, 
the operator is prompted with the 
message SYS1.DUMP CONTAINS DATA. 


If the data set is empty and the 


Size is not specified or is adequ- 


ate, control returns to Step 4. 


If OPEN pro- 


| 


NP60PNNG 


NP6 IOEOF 


NP6LOCAT 


NP6EMTY 


If the size specified in the para-|NP6SMAL 


meter is greater than the size of 
the data set, the operator is 
notified with the message SYS1. 
DUMP TOO SMALL and prompted to 
respecify or cancel the parameter. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
L 


The operator is notified with the |NP6EMTY 


12. 


13. 


14. 


message SYS1.DUMP SCRATCHED or 
UNABLE TO SCRATCH SYS1.DUMP and 
prompted to respecify the DUMP 
parameter. 


If allocation fails, the operator 


is notified and prompted to respe- 


cify the DUMP parameter. 


If OPEN processing fails because 
of insufficient space, SY¥S1.DUMP 
is disabled as in Step 1. If it 
fails for any other reason, the 
operator is prompted to respecify 
the DUMP parameter. 


If there is an I/O error, NIPSENSE|NP6BALIC 


is called, and the operator is 
prompted to respecify the DUMP 
parameter. 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
1 


NP6NOSCR 


NP6FAIL 


NP6CPNBD 


O€T 





From Diagram |1,.0, 
Step 3 


Processing 


NP6RMS 












Issue RMS initialization macro 


(IGFVNIP), IGFVNIP 








IGFVNIP calls IGFVCCIN to handle 
CCH initialization. IGFVCCIN 









IGFVNIP calls IGF YVMCFO to handle 
MCH initialization, 





IGFVMCFO 


Diagram 11.3: NP6RMS 
Initialize RMS (Recovery Management Support) 


IEAVNPO6 
Diagram 11.0, 
Step 4 
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Diagram 11.3: NP6RMS (IEAVNP0O6) 


+ 
Using BLDL, IGFVNIP loads, calls, |NP6RMS 
and deletes IGFVCCIN. If an error| 
occurs, a message is written to 
the operator via NIPWTOR. 


| 
| 
Using BLDL, IGFVNIP loads, calls, | 
and deletes IGFVMCFO. If an error| 
occurs, a message is written to | 
the operator via NIPWTOR. | 
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Diagram 11.4: NP6TRA 
Initialize the Trace Function 


cET 


From Diagram 11.0, 
Step 4 





Input Processing Output 








NP6TRA 
bi ean 


NVTPTAB 


ge Rae 


NVTNUCND 










Define trace table in lower portion of 
nucleus buffer. 







2 Move temporary trace table to permanent 
trace table, NP6MOVE 


Oe, 


ve 


TRACE parameter pointer 


= i aa yi 2 > 









3 Enable trace function. 


MODESET 


awe 


& 


| CVTTRACE 










IEAVNIPM 
Diagram 3.0, 
Step 4 






FLCTRACE 


SCVTRACE 


Wee ae 
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Diagram 11.4: NP6TRA (ITEAVNP06) 


| 1. If the TRACE parameter is not spe-|NP6NOTRA 
| cified or is equal to 0, the trace| 

[ function is disabled by putting a | 

| BR 11 in the CVT field CVITRACE | 
] and putting O's in FLCTRACE and | 
| SCVTRPTR. | 
| | 
| If the parameter is invalid, the |NP6INVAL 
[ operator is prompted with the mes-| 
| sage INVALID TRACE PARAMETER and | 
[ given the option to respecify or | 
; cancel the parameter. If he can- | 
[ cels, NVTNUCND is rounded to a 4K | 
{ boundary and CVTNUCB is set equal | 
| to NVTNUCND. The trace function | 
| is then disabled as above. | 
| | 
| If space is not available in the |NP6NOSPA 
| nucleus buffer, NVTNUCND is set | 

| equal to CVTNUCB, and the trace ( 

| function is disabled as above. | 

| The operator is notified with the | 

message INSUFFICIENT SPACE, and | 

| control is returned to the caller.| 

| | 

| If there is not enough space in | NP6SMALL 
| the nucleus buffer, the last entry| 

| pointer is set to CVTNUCB-32, and | 

| NVTNUCND is set to CVINUCB. The 

| Operator is notified that the 

| trace table size has been 

| decreased. 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 
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NO 
e 


| 
| 
| 
| 
If the two tables are equal in | NP6COPY 
size or the PTT (permanent trace _ | 

table) is larger, the TTT (tem- | 

porary trace table) is moved to | 

the PTT beginning with the lowest | 
address in each table (first entry| 
pointer). Any remaining area is 


set to O's. 


| 
| 
If the PTT is smaller than the [ 
TIT, as much of the TTT (starting | 
with the most recent entry) as [ 
will fit is moved to the PTT. [ 

4 


Het 


From Diagram 3,0, 


aE Processing 





JIEAVNPO7 


1° Define hardcopy console. 


Define pageable DCMs (display 


control modules). 


Define page algorithm limit 
values. 


Locate SVC OPEN Router 
routine in the LPA, 


Test for extended-precision 


floating-point feature. 











NP7HDCPY 


NP7PDCM 


NP7PAL 


NP7OTEST 


NP7EPFP 


JEAVNIPM 
Diagram 3.0, 
Step 5 


Diagram 12.0: IEAVNPO7 
Call Routines Sequentially 
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Diagram 12.0: IEAVNPO7 


oO ee ee oe es ee ee a ee ee 2 2 2 es ee ee 


{| 2 and 4. NP7PDCM and NP7OTEST call 

| NP7LPAFN to search the LPA. 
[ See Diagram 12.3 for a 

| 


description of NP7LPAFN. 
Ne i a ea 


9ET 





Diagram 12.1: NP7HDCPY 
Define the Console or System Log Data Set 
to be Used for Message Hardcopy 


From Diagram 12.0, 
Step | 


Processing 








NP7HDCPY 













1° Locate UCB for specified hardcopy 
device and initialize UCB and UCM. 


2 Put routing codes and command 
options in UCM, 





IEAVNPO7 
Diogram 12.0, 
Step 2 
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Diagram 12.1: NP7VHDCPY (IEAVNPO7) 


c 
{ 


—---—----—---—--------7 


Lee ee ee wee we ee wee one we we woe en oe oon n= 


Sa a a ee «---------- 

Notes on Processing | Label 

1. NP7HDCPY locates and verifies the |NP7HDCPY’ 
HARDCPY parameter input. 


IEAVNP0O1 determined whether a NP7HCINV 
hardcopy console was required. 

If SYSLOG is specified, NP7HDCPY NP7HCSLG 
identifies the system log as the 

hardcopy device. 

If HARDCPY is not specified and it|NP7HCREQ 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
is required, or if the specifica- | 
tion is in error, or if the con | 
sole is unavailable, NIPWTOR is | 
called to prompt the operator to | 
respecify the parameter. | 

| 
If HARDCPY is not specified and is|NP7HCXIT 
not required, control goes to Dia-| 
gram 12.0, Step 2. | 
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Diagram 12.2: NP7PDCM 
Relate Each Graphic Device 
to its LPA-resident DCM 


From Diagram 12.0, 


oeEe Processing 


NP7PDCM 










1 Find DCM associated with UCM for 
graphic console. 











NP7LPAFN 


Put DCM's entry - 
point address in 
RPARM 


RPARM 


Entry-paint oddress ——S 


UC 


UCMXB en foe ee 


2 Place entry -point address of DCM 
in resident DCM associated with 
the UCM entry. 








Pg UE J 
Entry -point address 


ot ee 


- wt 





IEAVINPOZ 
Diagram 12.0, 
Step 3 
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Diagram 12.2: NP7PDCM (IEAVNP0O7) 


NP7PDLST 


+ 
1. NP7PDCM examines UCM entries in | 
the nucleus-resident UCM and con- | 
structs the name of the associated| 

DCM for each graphic console by | 
adding the EBCDIC unit name from | 

the UCB to the DCM. | 

| 


t 
| 
| 
| 
| 
| 
| 
| If NP7LPAFN cannot find the DCM in|NP7PDNFN 
| the LPA, it sets the active con- | 
| sole flag in the UCB to Q and | 
| writes an error message to the [ 
| operator, uSing NIPWTOR, identify-| 
[ ing the missing DCM name and the | 
| unit address of the associated | 
| console. NP7PDCM returns control | 
| to Diagram 12.0, Step 3. | 
| | 
| | 
| | 
| | 
| | 
| | 
L i 


If the DCM is not found for the 
master console (a graphic con- 
sole), NIPSWAIT is called to put 
the system in a wait state (code 
X"3B"). 


Ont 


Diagram 12.3: NP7LPAFN 
Find a Module in the LPA 
From Diagram 12.2 or 


Input eee Processing 


NP7LPAFN 










1 


JEAQCDSR 


Search active LPA queue. 















Contents 
supervision 
routine 


pee | 


CVTQCDSR=address of 
IEAQCDSR 


> a dead 
oe BS fess 






2 Search active LPA directory. 


CVTLPDSR=oddress of 
IEAVVMSR 


Ca ne 


IEAVVMSR 
Contents 
supervision 
routine 


Output 








3 Indicate whether module was 
found, 





=Entry-point address 
if Found 
=0's if not found 


To caller 





Diagram 12.3: NP7LPAFN (IEAVNP0O7) 


ee ee as ey ee ee ee a 1 
| Notes on Processing | Label 


1. If the module is found, control 
goes to Step 3. 


| 
| 
| 2. The IEAQCDSR Search routine is 

| called before the IEAVVMSR routine 
| to give preference to a module 

| found in the fixed LPA or the LPA 
| update area. 
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Diagram 12.4: NP7PAL 
Define Page Algorithm Limit Values 


From Diagram 12,0, 
Step 3 


Input Output 


PARMTAB 


r a Pe 
ayy “ 
See 


Address of input 


we 


Processing 









NP7PAL 











AR gx 
1 2 


Locate and analyze PAL parameter 
input. 






NP7PATAB 


ase ee oO 







2 Set paging parameters. 


NP7PATAB 
nt Se ag. \*.* 






parameters 


met) 
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IEAVNPO7 
Diagram 12.0, 
Step 4 
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Diagram 12.4: 
---- 


NP7PAL (IEAVNPO7) 


-+ 


| Notes on Processing | 


T 
| 
> | 

| 


NP7PAL uses the system parameter 
table, PARMTAB, to locate the PAL 
parameter input. The first input 
source that is analyzed is the one 
from the IEASYSxx list of SYS1. 
PARMLIB. When the specifications 
from this source have been ana- 
lyzed and put in a takle, NP7PAL 
analyzes the operator-supplied PAL 
input. The subparameters are 
merged with duplicate specifica- 
tion of a subparameter, resulting 
in a parameter override; the last- 
Supplied definition (in the normal 
case, the operator overriding an 
IEASYSxx definition) for such a 
value will be the only effective 
specification. NP7PAL optionally 
displays the PAL subparameter 
values that result from its analy- 
Sis and allows the operator to 
respecify the PAL parameter. 


NP7PAL verifies that the PAL para- 
meter input is in the correct for- 
mat by examining each of the sub- 
parameter definitions in an EBCDIC 
matrix. If an error is encoun- 
tered, analysis of the PAL input 
from the operator or PARMLIB is 
terminated; any subparameters that 
are correctly and completely 
defined up to the point of the 
error are accepted. In the case 
of an error, the operator is 
informed via the INVALID PAL PARM 
message written by the IEAVNIPM 
NIPWTOR routine. The message 
identifies the input source as 
being either the PARMLIB or the 
oferator, and the operator is per- 
mitted either to respecify the 
remainder of the PAL parameter or 
to cancel his option and thereby 
accept the truncated PAL defini- 
tion, together with any systen- 
asSigned values. 


p———— — — — — — — — — — — 


Ca ee ee ee a T 
| Notes on Processing | 
}--------------------------------------- + 
| 2. Paging supervisor fields to Le | 
| set, together with their limit/ | 
| assumed values are: | 
| | 
[ PVTTBASE =(CVTEORM - CVTNUCB) /4096| 
| PVTLTH (LTH=) = 1 - 99; | 
[ assumed value = 5 | 
| PVTREPCT (REPCT=) 1 - 99; | 
| assumed value = 3 | 
[ PVTBFXTF (NFX=) = 8 - 9999; | 
| assumed value = .25 PVTITBASE | 
l PVTSFXIF = 1.25 PVTBFXTF | 
| PVTLFXTF = 1.5 PVTBFXTF | 
[ PVTLFXL = (PVTTBASE - PVTLFXTF); | 
| Maximum = 255 | 
| PVTSFXL = (PVTTBASE - PVTSFXTF); | 
| maximum = 255 { 
| PVTBFXL = (PVTTBASE - PVTBFXTF) ; | 
| Maximum = 255 | 
| PVTLRLIM (LRC=) = 0 - 9999; | 
[ assumed value = 5 | 
[ PVTHRLIM (HRC=) = 0 - 9999; | 
[ assumed value = 20 | 
l PVTLALIM (LRD=) = 0 - 9999; | 
| assumed value = 9999 | 
| PVTHALIM (HRD=) = 0 - 9999; | 
{ assumed value = 0 | 
| PVTIMEAD (MTIM=) = 1 - 9; 
| assumed value = 1 | 
| | 
| Assumed values are assembled into | 
| the respective NVT fields. The | 
[ assumed value for NFX= is expre- | 
| ssed as a fractional value, in | 
| hundredths, to be multiplied times | 
l PVTTBASE. | 
Las a ea 1 
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Diagram 12.5: NP7EPFP 
Test for the Presence of the 


From Diagram 12.0, Extended-precision Floating-point Feature 


Step 5 


Processing 





NP7EPFP 





1 Enter problem state. 


MODESET 












Issue SPIE specifying that interruptions 
from 0-15 are to be handled by the exit 
routine NP7SPIEX. 


Execute an LRER instruction to determine 
EPFP feature capability. 












Set switch in CVT indicating that all 
EPFP features except divide are present. 


CVTOPTA (byte 
CVTXPFP)=1 







5 Cancel SPIE environment. 


Return system to supervisor state. 










IEAVNIPM 
Diagram 3.0, 
Step 5 
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Diagram 12.5: 


NP7JEPFP (IEAVNPO7) 


C 


GN Poe eh eg oe ee ene ee ee, ee ee ee 


| Notes on Processing 


J —------------------------------------ + 


1. 


etd 
8 


NP7VEPFP must enter problem-program| 
state, since a program check can- 
not be tolerated in supervisor 
state. 


If no program interruption occurs, |NP7EPFP 


EPFP hardware iS present. 


| 

| 

| 

| 

| 

| 

| 
If a program interruption occurs, | 
the SPIE Exit routine, NP7SPIEX, | 
receives control via the control | 
program. The register contents ; 
upon receiving control are: | 
{ 

| 

| 

| 

| 


Register 0 
Register 1 
Register 2-13 


Unpredictable 
Address of PIE 

Same as at time of 
program check 
Return address | 
(to control program) 
Address of NP7SPIEX| 


Register 14 
Register 15 
The registers 0, 1, 2, 14, and 15 | 
have been saved in the PIE and | 
will be restored from that loca- | 
tion when the SPIE Exit routine is| 
completed. Registers 3-13 will | 
reflect any alterations made by | 
NP7SPIEX. | 

| 

| 


The PSW in the PIE (PIEPSW) is 
examined to determine what type of| 
interruption occurred. The resume| 
address in PIEPSW is then set | 
accordingly (note that this isa | 
BC (basic control) mode PSW). | 
an interruption code other than ( 
X°O1° (operation), the extended- | 
precision floating-point feature | 
is assumed to exist and PIEPSW is | 
set to Step 4. Otherwise, the | 
feature is assumed to be absent 
and PIEPSW is set to Step 5. [ 
1 


| Label | 
---------- { 


oe ces gees ee ee ee eo ee ee ee ge ee ee ee ees ee es es ee ee ee ee ee es ee re ee gs es oe ee ee a ee ee ee eee 


ee ee ee ee ee es ee a ww 2 


The divide-only switch (kit | 
CVTXPFP in byte CVTOPTA) is set to| 
ds 


This restores the program mask to 
its original value. 


Since the PIE is not automatically 
freed, TCBPIE is set to 0 to avoid 
leaving a useless and possibly 
misleading pointer in the master 
scheduler TCB. Actual freeing of 
the PIE is done at the time the 
final master scheduler region is 
estaklished. 


es ee 


NP7FPYES 


NP7FPNO 


NP7FPNO 


9nT 





From Diagram 3.0, 
Step 5 


Processing 


IEAVNIPX 


1 Define nonpageable area. 


Define task dispatcher's automatic priority 
group. 


Define the task dispatcher's time-sliced 
priority groups, 


Define quickcell areas. 


Define master scheduler region. 


Release NIP buffer space in SQA. 


Release CDEs and LLEs for NIP-loaded 
modules. 


(Continued at Step 8) 








Diagram 13.0 (1 of 2): IEAVNIPX 
Organize NIP Exit Processing 


NPXREAL 


NPXTMSL 


NPXQCELL 


NPXFBUF 
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Diagram 13.0: IEAVNIPX 


| Notes on Processing 


}— a a a 


- There is no diagram for NPXREAL. 


= 


| 
| 5. NPXMPA calls NPXMPA1 to limit 

| background and TSO use of auxi- 

| liary storage (see Diagram 13.5). 
| 


6. There is no diagram for NPXBUF. 
Fe a a 


BhT 





Processing 


Define free address space. 


Define master scheduler's LSQA, 


Define available page frames. 


Define shared subpool 0 for master 
scheduler and communication task, 


Reset NIP ABEND trap. 


Reset dynamic address translation 
tables and exit to master scheduler 
initialization program. 








Diagram 13.0(2 of 2): IEAVNIPX 
Organize NIP Exit Processing 


NPXFAREA 


NPXMLSQA 


NPXPFTAQ 


NPXMCSPO 


NPXRT RAP 


NPXRDAT 


13.10 


IEEVIPL 


master scheduler 
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Diagram 13.0: IEAVNIPX (Cont'd) 


OST 


Diagram 13.1: NPXAPG 
Define the Task Dispatcher's APG 


From Diagram 13.0 


Input Step 2 Processing Output 


NPXAPG 


[EAVNIPX 


Enter valid elements in a dummy APG 
control element in IEAVNIPX, 


Replace PARMLIB parameters with those 
respecified by operator, 


IEAVNIPX 


Move dummy APGCE into nucleus when 
all elements in the APG parameter have 
been analyzed, 


= 


NVTAPGCE 


IEAAPGCE 


CVTAPG=1 





IEAVNIPX 
Diagram 13,0, 
Step 3 
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Diagram 13.1: NPXAPG (IEAVNIPX) 
Ee ae re en Ee Eee ng fo er 1 


Notes on Processing | Label 
1. NPXAPG locates and examines the 
APG parameter. 


If the APG parameter is not 
defined or is invalid, NPXAPG does 
not modify the IPL values of 
CVTAPG and the nucleus~resident 
APGCE. 


ND 
e 


If there is an error in the 
definition of the parameter, 
NPXAPG issues the INVALID APG PARM 
message to the master console via 
the NIPWTOR routine (in IEAVNIPM) 
and allows the operator to respe- 
cify or cancel APG. If the opera- 
tor cancels APG, NPXAPG examines 
the next input source or exits (if 
the operator's input was in 
error). 


Ww 
® 


NPXAPG sets the APG active flag 
(CVTAPG) to 1. 

NPXAPG moves the dummy APGCE after| 
the scheduling priority (S.P.) is| 
converted to a dispatching fpriori-| 
ty (D.P.) by the formula: 


| 
APG D.P. = 251 - ((15 - S.P.) x | 
16). | 
a ee a eee 


CST 


Diagram 13.2: NPXTMSL 


Build the Required Number of TSCEs 
(Time Slice Control Elements) in the SQA 
From Diagram 13.0, 


Step 3 Processing Output 


NPXTMSL JIEAVNIPX 


Satna tes 


As ‘ s nm, ae nee 
In ut m————+t 10 Move each valid time slice group into 
P the TSCE build area in JEAVNIPX, TSCE build area 
PARMTAB 5 


a 


2 Acquire a TSCE area and move TSCEs to 


SQA area. ad GETMAIN 


JEAVNIPX 


“ i Ca a 
FSCE build area =——— | es ea I TSCE area 


From subpool 255 
of SQA Subpool 255 


(PE Seo Se 
IEAVNIPX Santali 
Diagram 13.0, 


Step 4 








:Z7 uotzoaS 


€ST uot RezedoO jo poyzewN 


C "6 C an @ 


Diagram 13.2: NPXTMSL (IEAVNIPX) 


De ee a ae ee eee | Sea aca mana 1 er ee ee er ee ee ("oe 
| Notes on Processing | Label | | Notes on Processing | Label 
| -------~-----=--—----------------------}---------- |---------------------------—-----------}--------- 
1. NPXTMSL builds the required number|NPXTMSL | 2. NPXTMSL requests an area equal in |NPXTMEND 
of TSCEs (time slice control ele- | | size to the packed TSCEs in the | 
ments) in the SQA and defines the | | IEAVNIPX build area. | 
time-slice intervals in units of | | | 
16 microseconds. | | NPXTMSL sets a flag in the last | 
| | TSCE to identify to the dispatcher | 
If the TMSL parameter is invalid, |NPXTMRTY | the end of the chain. NPXTMSL | 
NPXTMSL terminates its scan at | | also places the low address of the| 
that point and allows the operator| | SQA-resident TSCE chain in the CVT| 
to cancel or respecify the TMSL | at CVITSCE. | 
definition. If he cancels it, l----— --- - —— -— = 4---~------ 
NPXTMSL returns to the caller. If 
he respecifies, he need not respe- 
cify the time-slice groups defined 
previous to that in error since 
NPXIMSL retains the previous 
definitions in the IEAVNIPX TSCE 
build area and reuses this ared 
for further TMSL definitions. 


area relative to its priority -- 
priority 0 in the first slot, 
priority 1 in the second, etc. 


TSCE is the dispatching priority 
(D.P.). This is derived from the 
scheduling priority (S.P.), 0-13, 
by the formula: 


Time-Slicing D.P. = 251 - ((15 - 
S.P.) x 16) 


When the last valid time-slice 
group has been defined, the TSCEs 
are packed together in the kEuild 
area to eliminate zero-value time- 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
NPXTMLPN { 
| 
| 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
Slice TSCEs. | 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
{ NPXTMSL moves each into the build 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
( 
| 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
The priority value placed inthe | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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Diagram 13.3: NPXQCELL (IEAVNIPX) 


| Notes on Processing | Label 

1. If the quickcell definition is too|NPXQCNXT 
big for the work area, NPXQCELL | 
terminates the scan at the point 
of error and allows the operator 
to cancel or respecify the SQACEL 
or LSQACEL. 


If the operator cancels SQACEL, 
NPXQCELL sets up to process LSQA- 
CEL. If he cancels LSQACEL, it 
returns to the caller. 


If the operator respecifies the 
parameter, he need not respecify 
quickcell definitions previous to 
the one in error since previous 
definitions are retained and the 
area is reused for further quick- 
cell definitions. 


| 
l 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
When the last valid quickcell has |NPXQCEND 
been defined, the definitions are | 
packed together in the work area | 
to eliminate zero-value quick- | 
cells. Any respecification of a | 
given quickcell size results in | 
the last such specification being | 
effective. NPXQCELL calculates | 
the total required area for quick-| 
cells while packing the work area. | 
The first unused halfword after | 
the packed data is set to 0. | 
NPXQCELL also calculates the size | 
of the QCDBLK (quickcell descrif- | 
tion block). QCDBLK contains the | 
requirements for each quickcell. | 
| 

| 

| 

| 

| 

| 


NO 
e 


NPXOQCELL requests an area big NPQCLND 
enough to contain both the QCDBLK 


and the quickcells. 


= 
e 


NPXCCELL requests an area equal in|NPQCLND 
Size to the packed data work area | 
(including the extra halfword of | 
O's). | 

4 
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Diagram 13.4: NPXMPA 
Define Virtual Address Space Dedicated 
to Master Scheduler Region 

From Diagram 13.0, 


seas Processing Output 


NPXMPA 
IEAVNIPX 


Input 


1 Defermine needed size of master 







scheduler region and ensure that enough oe 
virtual space is available for this region. MPASIZE 





PARMTAB 





MPADDR start of 


MPA parameter 


master scheduler 













| 
—| 
| region 
| 
| —tT 2 Initialize master scheduler region PQE and POE 
CVTSHRVM 4 7 FBQE to reflect the calculated size and 
| starting address, ea a a a av TESTES 
1 | 
| FBQE 
NVTVVPGI1 = | 
3 Define page tables and external page tables 
pag 
| for segments allocated to master scheduler ae 
| region, ; IEAPTCD 
Master scheduler TCB — =| — 
Master scheduler PQE | | 4 Process TSOAUX and AUXLIST parameters. NPXMPAT External page tables 
| Establish limits on PO 
IEAVNIPX | background and TSO 
eee ee use of auxiliary storage 
13.5 
MPASIZE | 
core = ca 
' MPADDR 5 Disable system for all interruptions. MODESET 
IEAVNIPX 
Diagram 13.0, 
Step 6 
* ‘ . : 





~ 


Diagram 13.4: NPXMPA (IEAVNIPX) 
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2Z UuOT_IaS 


uoT}ZeAsdO JO POU ROW 


LST 


Notes on Processing | Label | | Notes on Processing | Lakel 
1. NPXMPA locates the pointer to the |NPXNOMPA 2. If there are multiple FBOES | NPXMPDEF 
MPA parameter. If the pointer has| defined for this PQE, the more | 
a value of 0, MPA has not been | recently created FBQEsS (at the | 
Specified, and the master schedul- front of the FBOE queue) are | 
er region is defined as two seg- dequeued, and the SQA space for | 
ments (Cor 128K bytes) of virtual those FBQES is released by FREE- | 
storage. MAIN (sukpool 255). The last FBQE| 
on the queue, created by IEAVNIPO, | 
If MPA has been specified, NPXMPA is retained rather than one of the| 
ensures that enough virtual space later-created FBQES in an attempt 
is available for the master sche- to decrease SQA fragmentation. 
duler region. NPXMPA calculates 
Since the remainder of NIP execu-~ [{OISABIE 


tracting the region size from the 
low address of the "shared virtual 
area™ (CVTSHRVM), which contains 
the SQA and the pageable LPA. It 
determines whether this address 
overlaps the high NIP page 
(NVTVVPG1). If these address 
Spaces overlap, the master sche- 
duler region cannot be defined as 
Specified. If there are less than| 
128K bytes, the operator is infor-] 
med that storage is unavailable, | 
and NPXMPA branches to the NIPS- _ | 
WAIT routine (in IEAVNIPM) to | 
place the system in a disabled | 
Wait state (X‘'38'). If there are | 
| 
| 
| 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
the low region address Ly sub- | 
| 
| 
| 
| 
| 
| 
| 
| 
| 


at least 128K bytes, the operator 
is informed that address space has 
been exceeded, and is given the 
Opportunity to redefine or cancel 
MPA. If he cancels, the 


master scheduler region is defined|NPXMPINV 


as 128K bytes by default. | 


ee a Se ee ce ee cme ee ee ee ee ee ee me me te 


| 
i 
tion occurs outside of any region | 
boundaries, IEAVNIPX protects its | 
existence ky not reenaoling the | 
system and not issuing ncen-tyre-1 | 
SVCs, which might reenable the j 
system. The exception is in the | 
case of a system wait stare. I[f | 
normal NIP execution continues, i 
the system is not reenabled until | 
control is passed to tne master | 
scheduler via the LINK SVC. 


8ST 





Input 


PVTTOTAX 


PVTSUCM 


GOVRFLB 


PARMTAB 
TSOAUX 


CVTPVTP 


SQ ABOUND 


Secondary CVT 


SCVTMSSQ 
IEAVNIPX 


MPADDR 
ae 


CVTREAL 


NVTPTAB 


PVTSUCM 


PVTTOTAX 
aed 
PVTDYNA 
vas 


PARMTAB 


(SA Sa 
TSOAUX 

Pes Ee ARES 
AUXLIST 


Fe RO NR 





Tek lcd SN ale 


PVTTOTAX 


MT re a 


PVTMA 


XB 
An ; flag > ek 


PVTDYNA 


“Vs oe #55 





From Diagram 13.4, 
Step 4 





Processing 


Diagram 13.5: NPXMPA1 


Establish Limits on Background and 


TSO use of Auxiliary Storage 


NPXMPA1 


1 Adjust space values to reflect 


auxiliary storage backup of pageable 


system areas, (ee eae 








Compute size of dynamic 


area, 







Determine PVTSUCM value (PVTSUCM 
total uncommitted auxiliary 
space). 





EAVNIPM 
If 500 or less. 





Operator notified that 
TSOAUX parameter is 
ignored 





NPXVNUM 


Verify the specification. 





Determine auxiliary space reserved for 
TSO use and set the upper boundary for 
batch allocation, = 





1EAVNIPM 
to operator. ; NIPWTO 


Write auxiliary storage limits 


Write total available 
auxiliary storage, 
background available 
storage, TSO available 
storage, current 
TSOAUX value, and 
TSO reserved pages 


NPXMPA 
Diagram 13.4, 
Step 5 


Output 


~ 


VT 


PVTTOTAX 


PVTSUCM 


PVT 


PVTDYNA 


PVT 
PVIMAXB 


= eemmen « 
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Diagram 13.5: 


NPXMPA1 (IEAVNIPX) 


PVTTOTAX and PVTSUCM must he 
decreased using the formula: 


PVTTOTAX = PVTSUCM = PVTTOTAX - 
(Beginning address of SQA - Begin- 
ning address of Master Scheduler 
Region) /4096 


Also must subtract pages Letween 
the beginning address of the LPA 
directory and the beginning 
address of the SQA. 


Computed in 4K pages; should be a 
multiple of 64K. It is decreased 
by 16 pages (64K) to reflect the 

master LSQA. PVTDYNA represents 

the maximum address space avail- 

able for region allocation. 


If PVTSUCM is not greater than 500 
pages, no auxiliary Storage is 
available for TSO use. The opera- 
tor is notified that the TSOAUX 
parameter has been ignored due to 
auxiliary storage restraints. The 
TSOAUX pointer in PARMTAB is set 
to 0 to show that the parameter is 
inoperative (processing for AUX- 
LIST will need to refer to this 
value). 


The maximum value for batch allo- 
cation (PVTMAXB) is set to PVTTO- 
TAX or PVTDYNA (whichever is 
smaller), and control goes to Dia- 
gram 13.5, Step 5. 


ee Sc es er, ce rr rs rs cm crs gs rr is og er os ee ee Soe“ 


A null pointer for TSOAUX in PARM-| 
TAB causes the upper koundary for | 
background allocation (PVTIMAXB) to| 
be set to the smaller of PVTDYNA | 
or PVTTOTAX. Control goes to Dia-| 
gram 13.5, Step 5. | 


| NPXMPA1 


The value specified must be 0-99. 
If improper, the TSOAUX entry is 
set to 0, and the operator is 
notified of the invalid specifica-| 
tion. The operator may enter EOB, | 
canceling the parameter, or he may| 
respecify the parameter. If he 
cancels it, PVTMAXB is set to the 
lesser of PVTDYNA or PVTTOTAX. 
Control goes to Diagram 13.5, Step 
te 


Since the cod- 
ing may be entered from multirle 
paths, and TSOAUX may be present 
due to operator specification, 
PARMLIB specification, respecifi- 
cation of an invalid value, or 
respecification following AUXLIST. 
AUXLIST always uses PARMTAB to 
extract the current TSOAUX value. 


This is necessary, 


and the smaller is multiplied by 
TSOAUX to find TSO reserved space. 
The space reservation for TSO must 
include at least 500 pages for 
potential batch use. If not, the 
operator is notified, and PVTMAXB 
is set to 500 pages. 


NPXMPA1 tries to locate the AUX- 
LIST parameter. If the parameter 
is 0, its control iS returned to 
the caller. 


The operator can accept the auxi- 
liary storage limits as displayed 
(EOB), or he may respecify TSOAUX. 
When PVTTOTAX is equal to or less | 
than 500 pages, an operator [ 
response is bypassed. (A respeci-| 
fication of TSOAUX automatically 
implies an AUXLIST). If TSOAUX is| 
respecified, and the operator [ 
response is in error and canceled; | 
the auxiliary storage limits are | 
left as previously computed and [ 
H 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
PVTTOTAX and PVTDYNA are compared, | 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


displayed. 
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Diagram 13.6: NPXFJPQ 
Release Control Blocks for 
NIP-loaded Modules 


Output 


From Diagram 13.0, 


Input SER oS Processing 


NPXFJPQ 











Master scheduler TCB 


NVT 
NVIMSTCB an ered 4 Dequeve LLEs (load list elements) from 
os the master scheduler TCB. 
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Diagram 13.6: NPXFJPQ (IEAVNIPX) 
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T 
Notes on Processing [ 
1. Each LLE is dequeuved starting at | 

the TCBLLE queue origin in the 
master scheduler TCB. Before the 
storage containing each LLE is 
released, the TCBLLE pointer is 
updated with the chain fointer to 
the next LLE. The processing is 
completed when all LLES on the 
queue have been released, and the 
TCBLLE pointer has a value of 0. 


No 
e 


Before dequeueing each CDE, 
NPXFJPQ determines whether an 
extent list is associated with the 
CDE by testing the extent-list- 
created flag in the CDE. If an 
extent list exists, its size is 
extracted from the extent list, 
and the storage containing the 
extent list is released. The rou- 
tine updates the TCBJPQ pointer 
with the chain pointer to the next 
CDE and releases storage contain- 
ing the dequeued CDE. This pro- 
cess continues until TCBJPQ has a 
value of 0. 


3. Storage occupied Ly released pro- 
grams is not released until avail- 
able storage is redefined by the 
NPXFAREA routine. 
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Diagram 13.7: NPXMLSQA 
Allocate the Single-segment LSQA 
Related to Master Scheduler Region 


Processing 









NPXMLSQA 






1 Allocate asingle SLQA segment. 


GETLSQA 


IEAVN IPM 
NIPSWAIT 


Place system in 
disabled wait state 
(X'38') 







lf cannot be done 





















2 Propagate the TCB values for the newly 
created LSQA and the TCB pointer to 
SWAH (system work area header) 
from the master scheduler's TCB to the 
communication task's TCB. 
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Diagram 13.7: NPXMLSQA (IEAVNIPX) 


1. The CVT NIP-in-process flag | NPXMLSOA 
(CVTNIP) is set, indicating to the| 
GETLSQA routine that the special | 
NIP interface for creating an LSQA| 
without a TCB is in effect. 
NPXMLSOA invokes the GETLSQA rou- 
tine via an SVC request. 
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| Before the wait state, NIPWTO NPXSW38 
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| 

| 

| 
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| 

| 

| 
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initialization of MPA. 


2. The master scheduler*s TCB will 
have been initialized by GETMAIN 
with the LSQA definition parame- 
ters. The NPXMLSQA routine propa-| 
gates the values to permit region | 
sharing. | 


| 
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Diagram 13.8: NPXPFTAQ 
Define Available Page Frames 
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4 Place PFTEs (page frame table entries) 

previously assigned as V=R pages on the 
available PFTE queue. 
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2 Add page frames at low end of available 
queue if available queue contains any PFTEs. 
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Diagram 13.8: NPXPFTAQ (LEAVNIPX) 
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Notes on Processing | Label 


NPXPFTAQ locates the PFT and | NPXPFTAG 
examines all entries in reverse [ 
order (beginning with the last). | 
| 
NPXPFTAQ initializes these PFTES |NPXPFCUR 
with PFTE indexes for the pre- i 
viously found available PFTE i 
(PFTBQPTR) and the next such PFTE | 
tc be found (PFTFQPTR). | 
| 
| 
| 
| 
| 
| 


NPXPFTAQ sets the PFTE index of 
the first available PFTE 
(PVTAVFST) to the index of the 
first PFTE placed on the available 
queue, if this queue is empty, and 
sets the backward queue pointer 
(PFTBQOPTR) to 0. 


NPXQPFTE 


NPXPFTAQ sets the PFTE index of NPXPFCUR 
the last available PFTE (PVTAVLOW) 

to the index of the last PFTE 

placed on the available queue and 

sets the forward queue pointer 


(PFTFQPTR) to 0. 


initialized by the NPXPFTAQ rou- 
tine to an initial value of 0O and 
increases the available page frame 
count (PVTAPC) ky the numker of 
PFTES added to the available 


| 
| 
| 
| 
| 
| 
| 
| 
NPXPFTAQ sets the PFTE fields not |NPXQPFTE 
| 
| 
| 
| 
| 
queue. [ 
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1. Allocate storage in subpool 255 of SQA 


for two SPQEs (subpool queve elements). 


2 Add SPQEs to the SPQE queue, 
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Diagram 13.9: NPXMCSPO 
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Scheduler and Communication Task 
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Diagram 13.9: NPXMCSPO (IEAVNIPX) 
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queue for the master scheduler TCB| 

(NVTMSTCB). The second SPQE area | 
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subpool 0 and is added at the head| 

of the SPQE queue for the communi-| 

cation task TCB (NVTCMTCB). This | 

SPQE points to the owning, or | 

master scheduler, SPQE (DCEPTR). | 
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is flagged as the last SPQE on the| 
SPQE queue. [ 


! 
] 
| 
! 
! 
! 
! 
{ 
| 
| 
] 
| 
| 
l 
! 
! 
| 
! 
! 
' 
j 
! 
1 
| 
( 
! 
! 
\ 
| 
( 
| 
( 
| 
| 
t 
| 
! 
{ 
| 
- 
| 
! 
! 
| 
| 
l 
| 
| 
i 
! 


as a a a ee 


:Z uot I—aS 


uotzerzsdo JO pouzeN 


LOT 


B9T 


From Diagram 13.0, 


Step 13 


Input 


NVT 


NVTSPUCB= 
PARMLIB UCB 


CVTREAL 


ieee nase Paneer 
oN 





CVTSEGC 
Cet 

CVTSEGD 
i> a 


Register 7=address of 
IEAMO DBR — 


Register 8=>MODESET 
code 


Register |Q=address 
of LINK SVC 

Register ]5=address 

of LINK list 





Diagram 13.10: NPXRDAT 
Reset DAT Tables and Exit to Master 
Scheduler Initialization Routine 


Processing | Output 


NPXRDAT 


Initialize register 4 with address of UCB 
related to online SYS1,PARMLIB data set, 





Register 4-NVTSPUCB 









Reset segment table and page table entries 
not containing addresses within the range 
required for the NPXRDAT routine. 


Segment table entires 








Page table entries 


Invalidate the page table entries for the 
pages containing the storage required for 
the NPXRDAT routine. 


Th 


Move the system segment table from its 
real storage location to the real storage 
location of the user segment table. 


O 
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CVTSEGC- CVTSEGD 


Set up registers needed for IEAVMODE and 
the LINK SVC to enable the DAT features 
and LINK to JEEVIPL. 


Enable DAT (dynamic address translation), | 


Pass control to the master scheduler 


Initialization routine (IEEVIPL). IEEVIPL 
routine 


Register 7~address of 
IEAMODBR 


Register 8B=MODESET 
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Diagram 13.10: NPXRDAT (IEAVNIPX) 

a ee eg eae Ge ee oe ae eee 
| Notes on Processing | Label | | Notes on Processing [label 

| -------~------------------------------- $---------- {0 |br-----------------+-+-------- 2 === =a fon == ---- 
| 1. This is the single parameter | NPXRDAT | | 3. This process operates with the DAT|DATOFF 

| passed to the IEEVIPL program. | { | feature disabled. Only real | 

| [ | | addresses are used for the { 

| 2. The DAT tables were created by | NPXRDAT | | remainder of NPXRDAT storage | 

{ IEAVNIPO for all real storage | | [ references including segment and | 

| addresses. { [ | page table invalidation. NPXRDAT | 

| | | [ locates the PTEsS (page table | 

| The pages between the top of the _ | | | entries) via the real address of | 

| nucleus (CVTNUCB) and the end of | [ | the system segment table (CVTSEGD) | 

| NIP‘s nonpageable region | { ky simulating the address transla-| 

| (NVTVVPG1) are invalidated. Page | | | tion process to isolate the | 

| table entries that are below the | | | affected PTEs. The PTES are set | 

| nenpageable line and are on the | | [ to a page-unassigned-by-GETMAIN | 

| available PFTE queue are set to | | | status. If this process results | 

| page-unassigned and not GETMAINed | | | in an entire segment invalid con- | 

{ status (PGTPAM,PFTPVM). Page [ | [ dition, the associated segment | 

[ table entries that are above the | | [ takle entry is set to a page- | 

| nonpageable line and were pre- [ | | table-unasSSigned status. | 

| viously assigned for NIP‘s use are] | | 

| set to the same status; however, | [ | 4. NPXRDAT purges the pre- {| NPXRDXRS 
| the page table itself will be | { [ invalidation values in the trans- | 

| released for any complete Segment | | | lation look-aside Luffer by issu- | 

[ of available storage above the | | | ing the PTILB instruction. The | 

| nonpageable line. Whenever an { [ | kuffer is used by the hardware to | 

{ entire page table is released, the| | { optimize the DAT frocess. i 

| corresponding segment table entry | | | 

| is set to a page-table-unassigned | | | 7.  IEAVMOLCE exits to the LINK SVC in |CVTLNKSC 
| Status (SGTPAM). With those rfages| ; { the CVT, which causes NIP to pass | 

| required for NPXRDAT, the asso- | { | control to the master scheduler's | 

[ ciated page tables may not be | | IEEVIPL routine. The normal LINK | 

| released during this process, and | { | SVC procesSing ensures that the | 

| both the segment table entries and| [ { IEEVIPL routine receives control | 

| the page table entries remain [ | { in key-O supervisor state. | 

| valid and assigned. [ [ L--_—_—-—~~-—~_-—~-—~-~~~----—----— --————-—------=- 4—~----__~___ J 
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SECTION 3: 


This section shows modules and subrou- 
It also con- 


tines that compose IPL/NIP. 


tains flowcharts for the NIPMOUNT subrou- 


Initial Program Loader 


PROGRAM ORGANIZATION 


tine of IEAVNPO2. 


These flowcharts are 
included to help explain the levels of sub- 
routines used in NIPMOUNT. 


ee ny py ge ee a ae OR Se PS me 1 
| TEAIPLOO | 
a a a a ee a ee J 
Nucleus Initialization Program 
ne ap anf gn pala rl nar a eg eR ea age oe CON Oa TE a er 7 
| ZEAVNIPO | 
Ss elt hs 4 
| TEAVNIPM | NIPABEND NIPSQEND NIPLOAD NIPSWAIT NIPSENSE NIPUCBFN NIPTIME NIPWTO | 
| | NIPWTOR NIPWTOR2Z NPMHDCPY NPMEXCPC NIPSVC NIPSVCX | 
a Pe en RP ney Sn en Eae MSPOR ge Yn ply ig Pg Argo Yo ee ea ae ee 4 
J IEAVNPO1|NP1INIT NPITESTC NP1TCOMM | 
-------- $-------------------------------------------------- +--+ ------------------------4 
| TLEAVNPO2|IEAVNPA2 IEAVNPB2 | 
agg a Pe ee ee eee 4 
| PENDS IE SPER NP3PBASE NP3PMLIB NP3SYSP NP3PLMRG NP3PTAE NP3LKLIB NP3LCAT | 
| TEAVNPO4 | NP4PSCAN NP4&PDEV NPYPDSEL NP4IPDT NP4YROSR1 NPYALLOC NP4YBPDIT NP4TLPA | 
| [NP4BCPQ NP4BPFT £=NP4APFT NP4YRQOBR2 NPUYBSQA NPUYIPVT | 
Setar Sia Se ee Se ea ee oe a Se oe eee aaa | 
| TLEAVNPA4 |NPAYGBUF NPA4FREE NPA4SREAD NPAUYWRIT NPAYINTF NPA4YRSTF NPA4YBCCV NPA4YINTC| 
| |NPA4LOAD NPA4CCST | 
Ba a aaa ee et ee ee | 
| TLEAVNPO5|NP5QSLPA NPSCSLPA NPSLPAPT NPSLPLIB NPSPOST NP5VTCB NP5SFIX NP5SBLDLF | 
| | NP5MLPA NP5BLDLP NPSLPDIR NPSSVC | 
Pty ny ee ef dR ey Se Ea gS Sn yo oe ey a ene ee | 
| LEAVNPA5|NPASINIT NPASCLPA NPASMLPA NPASBLEL NPASTERM NPASADDR NPASPOST NPASLOAD| 
| |NPASDIR NPA5SDIR NPASALPD NPASLGRP NPASCLIN NPASLIND NPASALIS NPAS5SBDIR| 
i a a ee er | 
| TLEAVNP06 | NP6DSS NP6RMS NP6 DMP NP6EXCP NP6TRA NP6MOVE | 
-------- {—----~-------------------------- === ---5---- ~~ 5 === === === === === === 
| IEAVNPO7|NP7HDCPY NP7PDCM NP7PAL NP7OTEST NP7VEFFP NP7LPAFN | 
Peestotebe= seco le eee eee ee ee ea oe er eee ee ese eee eee | 
| TLEAVNIPX | NPXAPG NPXTMSL NPXOQCELL NPXMPA NPXMPA1 NPXBUF NPXFJPQ NPXFAREA | 
{ | aise NPXPFTAQ NPXMCSPO NPXRTRAP NPXRDAT | 
Bach a ee ee ee ee ee eee | 
Figure a Organization of IPL/NIP modules and sukroutines 
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Chart AA. NIPMOUNT Processing (Page 1 of 3) 
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Chart AA. NIPMOUNT Processing (Page 2 of 3) 
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Chart AA. NIPMOUNT Processing (Page 3 of 3) 
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SECTION 4: DIRECTORY 


This section contains a directory of IPL/NIP mcdules, arranged by entry-point name. 





[Entry Point} Function of Routine —t™*” | Module |Diagram No. |Likrary| 
| IEAIPLOO [Unused entry point. = = irgarpL00| 1.0 ~| Nuc | 
| IEAANIPO |Unused entry point | eat eBO| 2-0 | Nuc | 
| IEAVNIPM |Normal entry to control routines ELON | 3.0 | Nuc | 
| IEAVNIPX |Finishes nucleus initialization one 13.0 | Nuc ! 
| IEAVNIPO eats nucleus initialization hecauNeat| 2.0 | Nuc | 
| IEAVNPA2 ineaeing a specific DASD or tape I PERU NBOS| 5a 1 | Nuc | 
IEAVNPA4 ez requests to SYS1.PAGE data sets eaRp All 8.0 : Nuc ! 
| IEAVNPAS neiees LPA modules for quickstart eengREAS) 10.0 | Nuc | 
| IEAVNPB2 tegeae a specific data set Peer 5.2 | Nuc | 
| IEAVNPO1 |initializes system consoles ERO 4.0 | Nuc | 
| IEAVNPO2 |System library initialization ere 5.0 | Nuc | 
| IEAVNPO3 amine system parameters Ravep 0s 6.0 | Nuc | 
| IEAVNPO4 leqaesiees paging control blocks aayNDOl 7.0 | Nuc | 
| IEAVNPO5 Peau shared storage ere 9.0 | Nuc | 
| IEAVNP06 eadeetsalieas reliability and serviceability PTEAUNOOE| 11.0 | Nuc | 
| | features | | | | 
| IEAVNPO7 yavedsaes HARDCPY and PAL parameters ean 12.0 | Nuc | 
| NIPABEND a SVC SLIH for ABEND fo 3.0 ! Nuc | 
| NIPLOAD |Loads NIP processor modules Seen 3.1 | Nuc | 
| NIPSENSE ie ceeueee sense data after I/O failure MONT EH 3.0 | Nuc | 
| NIPSQEND aGenal entry from GETMAIN RAUN TENT 3.0 : Nuc | 
| NIPSVC eae requested type 3 or 4 SVC routine into Le eNaN TaN 3.2 | Nuc | 
; {real storage | | | | 
| NIPSWAIT |Stores system completion code, places system leowtea 3.0 | Nuc | 
| Jin disakled wait state [ | | | 
| NIPT IME | Determines correct time from TOD clock at 3.4 | Nuc | 
| NIPUCBFN |Locates UCB associated with device Fare 3.3 | Nuc | 
| NIPWTO icra messages to operator | TEAvNrPH| 3.0 Nuc \ 
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C 


en aig ae Se ee ee eg ia ot To i 
JEntry Point] Function of Routine | Module |Diagram No.|Libra 
a es a Na iS Sa Se 4——--—---4-_---------4----- 
| NIPWTOR |Writes messages to operator and receives | LEAVNIPM | 3.0 | Nuc 
ee Te ie 
| NIPWTOR2 |Moves operator reply to specified buffer | LEAVNIPM | 3.0 | Nuc 
| | | | | 
| NPAYFCEA |Channel end appendage for formatting SYS1. | LEAVNPAS | 8.0 | Nuc 
| | PAGE data sets | | | 
| | | | | 
| NPAYFXCA |Abnormal end appendage for formatting SyYS1. | LEAVNPAS | 8.0 | Nuc 
| |PAGE data sets | | | 
| | | | | 
| NPAYNOAP |Dummy I/O appendage used as SIO, PCI, and end | IEAVNPA4G| 8.0 { Nuc 
| |of extent appendage | | | 
| | | | | 
| START |Begin initial program load | LEAIPLOO | 1.0 | Nuc 
Pee aa ast ce a SR ee eee eee Ge te cere 

Section 4: Directory 


4 
ry| 


cc ee ee ee ee hi 
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SECTION 5: DATA AREAS 





This section contains information about, and descriptions of, the following Data 
Areas: 


IPLDATA 

NIPMOUNT Parameter List 

NIPOPEN Parameter List 

NIPWTO Message Header 

NVT (NIP Vector Table) 

PDIT (Page Device Information Table) 
Page Device Table 

NIP PARMAREA 

PARMTAB (Parameter Address Table) 
Parameter Table Entry 

Quickstart Record 1 (NIPQSR1) 
Quickstart Record 2 (NIPQSR2) 
Quickstart Record 3 (NIPQSR3) 
Slot Queue 

SPE (NIP System Parameter Entry) 


IPLDATA 
Pointed to by: Register 3 on entry to IEAVNIPO 
Size: 20 bytes 
Initialized Ly: IEAIPLOO 
Bytes and } 
Displacement Bit Pattern Field Name Description 
0(0) 6 IPL unit volume serial 
6 (6) 5 IPL unit VTOC CCHHR 
11(B) 1 Nucleus member ID 
12(cC) 4 SYS1.NUCLEUS data set start CCHH 
16 (10) 4 SYS1.NUCLEUS data set end CCHH 


NIPMOUNT PARAMETER LIST 


Pointed to by: Register 1 (RPARM) 
Size: 21 bytes 
Initialized by: Module calling NIPMOUNT (IEAVNPA2) 
Bytes and 
Displacement Bit Pattern Field Name Description 
0(0) 12 NMNTDS The left-justified data set name in EBCDIC 
0(0) 4 NMNTDSA When NMNTFLI flag is set, the address of a 4u-byte 
data set name 
12(cC) 6 NMNTVS The volume serial (EBCDIC) of the direct access : 
device 
18(12) 2 NMNTDT The device type of the volume to be mounted or 0 
if any device type is acceptable “ 
20(14) 1 NMNTFL NIPMOUNT flags: 
aeese, ae NMNTFLI The parameter list contains the address of a 44- 
byte data set name 
eoiere Gres NMNTFLC Operator may cancel the mount request via an EOB 
reply 
eae ee NMNTFLB UCB address given 
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NIPOPEN PARAMETER LIST 


Pointed to by: 


Size: 


Initialized by: 


Displacement 
0(0) 


0(0) 


12(c) 
16 (10) 


20 (14) 


21(15) 


Register 1 (RPARM) 


24 bytes 


Module calling NIPOPEN 


Bytes and 


12 
rm 


0000 
0000 
0000 


Bit Pattern 


Uae 


ares 
eel. 


nie 


0000 


0100 
1000 


NIPWTO MESSAGE HEADER 


Pointed to by: 


Size: 


Initialized by: 


Field Name 


NOPNDS 
NOPNDSA 


NOPNDCB 
NOPNUCB 


NOPNFL 
NOPNFLM 


NOPNFLI 


NOPNF LNB 


NOPNFLB 
NOPNFLC 


NOPnFLSX 


NOPNRC 


Register 1 (RPARM) 


Description 
The left-justified data set name in EBCDIC, or 


Address of a 44-byte data set name if NOPNFLI flag 
is set 
Address of the related DCB 
Address of the UCB for the device on which the 
volume is to ke mounted 
NIPOPEN flags: 
Data set not found message is to be suppressed 
(valid only for conditional requests) 
The parameter list contains a 44-byte data set 
name 
Construct entire DEB (DCB must point to build 
area or DEB will be built at end of nucleus) 
DEB to be added to end of nucleus 
Conditional request; if NIPOPEN fails, register 1 
(RPARM) will ke set to two's complement 
Data set deScription to be limited to first 
extent 
NIPOPEN return code: 
Successful 
Data set not found 
I/O error 


or, if NIPWTCR request, by NIPWTOR parameter list 


Module calling NIPWTO 


Displacement Bit Pattern 


0(0) 
2(2) 


3(3) 
4(4) 


4 bytes 
Bytes and 
2 
1 
kj Reais eeeses? 
1 
Variable 


NIPWTOR PARAMETER LIST 


Pointed to by: 


Size: 


Initialized by: 


Displacement 
0(0) 


4 (4) 
8 (8) 
10 (A) 


11(B) 


Field Name 
NWTOLNG 
NWTOFL 
NWTOFLNH 


NWTOMSG 


Register 1 (RPARM) 
12 bytes 
Module calling NIPWTOR 


Bytes and 
Bit Pattern 


HNP Ee 


ee 


1... 


Field Name 
NWTORRPA 
NWTORECB 
NWTORRDL 
NWTORFL 
NWTORFLA 


NWTORFLB 


Description 
Message length including header 


Message flag: 

Message is not to ke hardcopied 
Reser ved 

Message text 


Description 
Address of the area to contain the reply 


Address of the reply ECB 
The length in bytes of the reply area 
NIPWTOR flags: 
NIPWTOR is not to wait for reply completion 
(asynchronous request) 
NIPWTOR2 is to provide an SQA reply buffer 
Reser ved 
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| NIP VECTOR TABLE 


Pointed to by: 


Si 


Ze: 


Initialized by: 


Displacement 
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00) 


8(8) 
9(9) 


10(A) 


11 (B) 


12(C) 
16 (10) 
20 (14) 
24(18) 
28 (1C) 
32 (20) 
36(24) 
40 (28) 
44 (2C) 
48 (30) 
52(34) 
64 (40) 
65(41) 
66 (42) 
68(44) 
72 (48) 


76 (4C) 
92 (5C) 
96 (60) 
100 (64) 
104 (68) 
120(78) 
122 (7A) 
123 (7B) 


124(7C) 
128 (80) 


132(84) 
134 (86) 
136 (88) 
140(8C) 
144 (90) 
148 (94) 
152(98) 
156(9C) 
160 (AO) 
164 (A4) 
168 (A8) 
172 (AC) 
180(B4) 
184 (B8) 
200(C8) 


(NVT) 


Register 2 
310 bytes (approx.) 


TEAVNIPO 


Bytes and 


Po lem 
eel. 


-_ 


vat arg 


= 
SFENFRPNS HLS HLSEL SE SLSES 


_ 


ray 
PRPNHOALHLEA 


1... 
Poe ee 


ae 
FOaOfoOFrEefFEeEF EF ENN 


8 


Bit Pattern 


Tete a 
ae Lies 
paps ee 


(RNVT) 


Field Name 


NVTNPSUF 


NVTNPSFX 
NVTPXIT 


NVTNPATR 
NVTNPREN 
NVTNPREU 
NVTFLLB 

NVTFLSLB 
NVTMSTCB 
NVTCMTCB 
NVTAPGCE 
NVTVBLDL 
NVTIGCER 
NVTPTCD 

NVTVVMDI 
NVTITMSLNK 
NVTPQCI 

NVTDSSNG 


NVTSQANO 
NVTNRANO 
NVTIPGNO 
NVTABSAV 
NVTPQSAV 


NVTNUCND 
NVINBFND 
NVTVVPG1 


NVTTRACE 
NVTFLSG 
NVTFLCN 
NVTFLAC 
NVTFLIOC 
NVTFLNHC 
NVTFLNCK 
NVTFLRAC 


NVTWTPSW 


NVTIDPSW 
NVTFLWS1 
NVTLOAD 

NVTSENSE 
NVTSWAIT 
NVTTIME 
NVTUCBFN 
NVTWTO 

NVTWTOR 
NVTWTOR2 
NVTPAGIO 
NVTNIPM 
NVT NMBLD 


NVTDCBIC 


Description 
List of suffixes to ke appended to the base IEAVNP 


to form the name of the NIP modules to be used 
next 

Index tc ke used in determining which suffix in 
NVTNPSUF is to be appended next 

Suffix to be appended to form the name of the exit 
module IEAVNIPX 
Attributes of executing module: 

Reenterable 

Reusable 

Library status indicator: 

SVCLIB and LOGREC defined 
Address of master scheduler TCB 
Address of communications task TCB 
Address APG table 
Address BLDL table 
Address SVC error routine 
Address Create/Destroy Page Table routine 
Address LPA hash value 
Address link parameter List 
Address Quickcell Initialization routine 
Address DSS Mask-Out routine 

Reserved 
Number of 
Number cf 
Number of 


initial SQA pages 
available NIP pages 
initial buffer pages 
Save area fcr original SVC 13 entry in Svc table 
Save area for original get-SQA-fpage entry in page 
vector takle 
Reserved 
Address of next available byte in nucleus buffer 
Address of end of nucleus buffer 
Address of first pageakle page 
Reserved 
Number of trace table entries 
Reserved 
Message handling indicators: 
Active master console 
Composite master console 
Hardcopy discontinued 
TOD clock inoperative 
WTOR reply outstanding 
Reserved 
System wait state PSW NIP modifies the following 4 
bytes of the PSW 
PSW ID (NIP module identifier) 
System wait state code 
Address of NIPLCAD in IEAVNIPM 
Address of NIPSENSE in IEAVNIPM 
Address of NIPSWAIT in IEAVNIPM 
Address of NIPTIME in IEAVNIPM 
Address of NIPUCBFN in IEAVNIPM 
Address of NIPWTO in IEAVNIPM 
Address of NIPWTOR in IEAVNIPM 
Address of NIPWTOR2 in IEAVNIPM 
Address of IEAVNPA4 
Save area for IEAVNIPM base register 
NIPM BLEL entry 
Reserved 
Address of input console DCB 


C 


204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EO) 
228 (E4) 
232 (E8) 
234 (EA) 


235 (EB) 
236 (EC) 
240 (FO) 
244 (F4) 
248 (F8) 
252 (FC) 
254 (FE) 
256(100) 
260(104) 
264 (108) 
268(10C) 
272(110) 
276(114) 
280 (118) 
284(11C) 
288 (120) 
304 (130) 


Displacement 


0(0) 
40 (28) 


41(29) 


42 (2A) 
44(2C) 
45 (2D) 
48 (30) 
52 (34) 
100 (64) 
104 (68) 
105(69) 
108 (6C) 


109 (6D) 


PNHNrE Ee FES 


p 
PATE HFEF FE ENN SLE RP 


rt 
* 


Bytes and 
Bit Pattern 


40 

1 
1... 
o1.. 
ool. 
coed 


1 


WrRPeE Oo Ww 


— 


5 ee 


lara ee 
Pl lee 
mad 


NVTDCBOC 
NVTUCCBSN 
NVTMBUF 
NVTMBEND 
NVTSPE 


NVTTOD 
NVTABCD1 
NVTABWS1 


NVTIPDT 
NVTPAREA 
NVTPTAB 
NVTQS BUF 


NVTSPUCB 
NVTVVTCB 
NVTVVECB 
NVTVRECB 
NVTVRBLD 
NVTBLDL 
NVICSLIB 
NVTCS LNM 
NVTCSIOB 


NVTFLPO 
NVTFLLST 
NVTFLQS 


PAGE DEVICE INFORMATION TABLE 


Field Name 


PDITIOB 

PDITFLG1 
PDITSSDV 
PDITMHDV 
PDITXCP 

PDITPON 

PDITOAPF 
PDITMIOB 
PDITNOPS 
PDITINDX 


PDITIOBP 
PDITCPCT 
PDITLACP 
PDITECB 
PDITDEB 
PDITDCB 
PDITSCNT 
PDIT1ISQA 
PDITSQCT 


PDITHSOQA 


Address of cutput console DCB 
Address of SYS1.NUCLEUS DCB 
Address of next available byte in message Ltuffer 
Address of end of NIP message buffer 
Address of first SPE in queue 
Reserved 
Save area for TCD clock readings 
Save area for first ABEND code processed 
Save area for wait state code ufon entry to NIPA- 
BEND in IEAVNIPM 
Reserved 
Address of initial page device table 
Address of first PARMAREA obtained (by IEAVNPO3) 
Address of PARMTAB 
Address of quickstart buffer 
Reserved 
Address of SYS1.PARMLIB UCB 
Address of IEAVNPAS TCB (pageable TCB) 
Address of ECB for IEAVNPAS5 
Address of ECB for IEAVNPO5 
Address of LPA BLDL entry 
Address of BLDL table build area 
Address of SYS1.LPALIB DCB 
Address of current LPA name 
Address of IOB for failing coldstart I/O requests 
Reserved 
Parameter option indicators: 
Display PARMLIB lists 
LPA may be quickstarted 


Description 
IOB for this device 


Flags: 

This is a set sector device 

Moveable head device 

Device needs to be restarted via EXCP 

Slot queues are being searched for a primary slot 
Channel program appended 

Multiple-exposure device 

No primary or secondary slot found on slot queue 
Displacement used to determine base IOB for this 
device; base IOB = address of IOB for this expo- 
sure - (4 X PDITINDX) 

Displacement to find IOB for next exposure (cur- 
rent IOB + PDITIOBP) 

Number of channel programs chained to this IOB 
after a PCI had been set 

Address of the last channel program on chain for 
IOB 

ECB for this device 

DEB for this device 

DCB for this device 
Number of slot queues for this device 
Address of slot queue for first slot for this 
device 
Number of channel programs on slot queue contain- 
ing the most channel programs 
Address of slot queue containing the most channel 
programs 
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PAGE DEVICE TABLE 


Displacement 


NIP PARMAREA 


Pointed to by: 


0(0) 
1(1) 
2(2) 
4 (4) 
6 (6) 
8 (8) 
9(9) 
10 (A) 


11 (B) 
16 (10) 
18 (12) 
20 (14) 
21(15) 
24(18) 
25(19) 
28 (1C) 
29(1D) 


Size: 


Initialized by: 


Displacement 


Bit Pattern 


Bytes and 

Field Name 
PDTNO 
PDTLSN 
PDTAPC 
PDTLGN 
PDTSEL 
PDTALI 
PDTTG 
PDTFL1 
PDTDEVT1 
PDTDEVT2 
PDTLAST 
PDTBA 
PDTR1 
PDTGC 
PDTSG 
PDTCCVA 
PDTR2 
PDTEMA 
PDTDT 
PDTIOB 


PRPRENMNEF 


eras 
Pas ieee 
ened 


WRPWEWRPYONW 


NVTPAREA 
Variakle 
IEAVNPO3 


Bytes and 


Bit Pattern Field Name 


Description 
Device number used to index into the PDT 


Last assigned slot number 
Number of available pages on this device 
Last assigned group number 
Slot entry length 
Alternate slot increment 
Number cof tracks per group 
Flags: 
Primary device 
Fixed-head device 
Last PLTE 
Beginning CCHHR of paging data set on this device 
Reserved 
Number of groups per cylinder 
Number of slots per group 
Address of cylinder count vector 
Reserved 
Address of kit map for this device 
Device type field from UCB 
Address of IOB for this device 


Description 








0(0) 4 NIPPAQ Address of next 4K block in parameter area 
4(4) u NIPPABYT Address of next available byte in PARMTAB 
44444 £444 4444444PARMLIB BLDL Ent ly t## tee te tee ee ee 
8 (8) 4 NIPPABDH BLDL header 
12(C) 8 NIPPANAM PARMLIB memkter name 
20 (14) 3 NIPPATTR Member TTR entry 
23(17) 3 Reserved for BLDL entry 
26 (1A) 6 Reserved 
KEKKAEEEEEEEEEEST/O Data AT Cate EEEEEEEEEEEES 
32 (20) 32 NIPPATXT CCWs for reading text record 
64 (40) 5 NIPPASID Search ID for next text record 
69 (45) 3 Reserved 
72 (4C) 40 NIPPAIOB PARMLIB IOB 
112 (70) 4 NIPPAIOB PARMLIB DCB 
116(74) 4 NIPPAECB PARMLIB ECB 
120 (78) 48 NIPPADEB PARMLIB DEB 
168 (A8) 80 NIPPARCD Read area for PARMLIB records ‘ 
248 (F8) 232 NIPPAPTB Parameter address table 
480(1E0) 1568 NIPPABUF Initial PARMAREA buffer 





180 


PARAMETER ADDRESS TABLE (PARMTAB) 


C Pointed to by: Within PARMAREA 


Size: 232 bytes 
Initialized by: IEAVNP 03 
Bytes and 
Displacement Bit Pattern Field Name Description 


° 248 (F8) 8 PTABSTRT Dummy entry 
256(100) 4 APGP Address of automatic priority grour parameters 
specified via SYSP (PLIBTAB) 
e 260 (104) 2 APGP flags 
262 (106) 2 Source identification: 
0000 0000 Operator (CPERTAB) 
Cie, “eres IEASYSxx via SYSP 
264 (108) u APGO Address of automatic priority group parameters 
specified Ly operator 
268 (10C) 2 APGO flags 
270(10E) 2 Source ID 
272 (110) 4 AUXLIST Not applicable 
276(114) 2 AUXLIST flags 
278 (116) 2 Source ID 
280(118) 4 BLDL Address of PARMLIB member for BLDL 
284(11C) 2 BLDL flags 
286(11E) 2 Source ID 
288 (120) 4 BLDLF Fixed BIDL list 
292(124) 2 BLDLF flags 
294 (126) 2 Source ID 
296(128) 4 CLPA Address of create link pack area parameter string 
300 (12c) 2 CLPA flags 
302(12E) 2 Source ID 
304 (130) 4 CONT Line continuation 
308(134) 4 Reserved 
| 312 (138) 4 CPQE Address of channel program queue extension 
tw parameters 
316 (13C) 2 CPQE flags 
318(13E) 2 Source ID 
320 (140) 4 DUMP Address of tape for SYS1.DUMP 
324(144) 2 DUMP flags 
326 (146) 2 Source ID 
328 (148) 4 FIX Address of list of routines in fixed LPA 
332 (14C) 2 FIX flags 
334(14E) 2 Source ID 
336 (150) 4 HARDCPY Address of hardcopy log parameters 
340(154) 2 HARDCPY flags 
342(156) 2 Source ID 
344(158) 4 Reserved 
348 (15C) 2 
350(15E) 2 
352 (160) 4 LSQACEL LSQA gquickcell farameters 
356 (164) 2 LSQACEL flags 
358(166) 2 Source ID 
360 (168) 4 MLPA Address of list of routines in LPA extension 
364(16C) 2 MLPA flags 
. 366 (16E) 2 Source ID 
368(170) 4 MPA Master scheduler region virtual space 
372 (174) 2 MPA flags 
. 374 (176) 2 Source ID 
376 (178) 4 OPI Operator intervention 
380(17C) 2 OPI flags 
382(17E) 2 Source ID 
384 (180) 4 PAGEP Address of page data set parameters from IFASYSxx 
via SYSP (PLIBTAB) 
388(184) 2 PAGEP flags 
390 (186) 2 Source ID 
392(188) 4 PAGEO Address of page data set parameters from OPERTAB 
396 (18C) 2 PAGEO flags 
398(18E) 2 Source ID 
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400(190) 


4O4(194) 
406 (196) 
408(198) 


412(19C) 
414 (19E) 
416(1A0) 
420 (1A4) 
422(1A6) 
424 (1A8) 
428 (1AC) 
430 (1AE) 
432(1B0) 
436(1B4) 
438 (1B6) 
440(1B8) 
444 (1 BC) 
446(1BE) 
448 (1C0) 
452(1C4) 
454 (1C6) 
456(1C8) 
460 (1CC) 
462(1CE) 
464(1D0) 
468 (1D4) 
470(1D6) 
472(1D8) 


Displacement 


0 (0) 
4(4) 


5 (5) 


6 (6) 
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HN Nh 


FNONM SFNHONHN FHON ENN FHNHN SENN FNHN EN ND 


PARAMETER TABLE ENTRY 


Each Parameter Table Entry 


Bytes and 


Bit Pattern 


4 
1 


Lia es ateene 

Pe ere 
1 

Like. Sees 
2 

X'0000° 

Cc*xx'* 


PALP 


PALO 


REAL 


SQA 


SQACEL 


SYSP 


TMSL 


TRACE 


TSOAUX 


PTABEND 


Address of paging algorithm limits from IFASYSxx 
via SYSP (PLIBTAB) 

PALP flags 

Source ID 

Address of paging algorithm limits from operator 
(OPERTAE) 

PALC flags 

source ID 

Nonpageable address limit 

REAL flags 

Source ID 

Address of SQA virtual space 

SQA flags 

Source ID 

SQA quickcell 

SQACEL flags 

Source ID 

Address of list of IEASYSxx member names 
SYSP flags 

Source ID 

Address of time-slice group parameters 
TMSL flags 

Source ID 

Address of trace takle entry parameters 
TRACE flags 

Source ID 

TSOAUX parameter list 

TSOAUX flags 

Source ID 

Dummy entry for end 


is eight bytes long and has the following format: 


Field Name 


NIPPTADR 
NIPPTOPF 
NIPPTOPI 
NIPPTLST 
NIPPTATF 
NIPPTMRG 
NIPPTSID 


Description 
Address of parameter specifications 
Entry flags: 
OPI option 
List option 
Attribute flags: 
Merge 
Source ID: 
Operator 
PLIB memker suffix 








QUICKSTART RECORD 1 (NIPQSR1) 


Pointed to by: None 
Size: 4096 bytes 
Initialized Ly: IEAVNPO4 
Bytes and 
Displacement Bit Pattern Field Name 
0(0) 8 NIPQSR1N 
8 (8) 1 NIPQSRiF 
Ds exe eeeubva te 
oe oe 
9(9) 1 
10 (A) 2 NIPQSRIT 
12(Cc) 2 NIPCSR1A 
14(E) 2 NIPQSR1iL 
16 (10) 4 
20 (14) 3 NIPQSR1iP 
23(17) Ht 
24(18) Variable NIPQSRiM 
0 NIPOSRIA 
NIPQSR1U 


QUICKSTART RECORD 2 (NIPQSR2) 


Pointed to by: NIPQSR1P 
Size: 4096 bytes 
Initialized by: IEAVNPO4 
Bytes and 
Displacement Bit Pattern Field Name 
0(0) 8 NIPQSR2N 
8(8) 4 NIPQSR2L 
12(C) 4 NIPQSR2H 
16 (10) 4 NIPSWR2D 
20 (14) 3 NIPQSR2P 
23(17) 1 
24 (18) Variable NIPQSR2M 
0 NIPQSR2A 
1 NIPCSR2U 


QUICKSTART RECORD 3 (NIPOSR3) 





Description 
"PAG1" EBCDIC record identifier 


Device identification indicators: 
Primary page device 
Page device with LPA guickstart records NIPQSR2 
and NIPOQSR3 
Reserved 
Number of formatted tracks 
Number of availakle pages (APC) 
Number of halfwords in bit map beginning at 
NIPQSR1M 
Reserved 
TTR of NIPQSR2 
Reserved 
Bit map of page availakility 
Page record available 
Page record unavailable due to I/O error on ini- 
tial page write 


Description 
"PAG2" EBCDIC record identifier 


Virtual address assigned to the start of the LPA 
directory 

Highest virtual address assigned to the LPA 

Hash value for LPA directory 

TTR of first NIPQSR3 record 

Reserved 

Bit map of pages 

Page record available 

Page record unavailable (assigned to quickstart 
LPA) 


Pointed to by: NIPCSR2P or NIPQSR3P 
Size: 4096 bytes (There will be 1 to 3 NIPQSR3 Records defending on the size 
of the LPA to be described.) 


Initialized by: IEAVNPO4 


Bytes and 
Displacement Bit Pattern Field Name 

0 (0) 8 NIPQSR3N 
8 (8) 1 NIPQSR3D 

0 

x 
9(9) 3 NIPQSR3P 
12(C) Variable NIPQSR3M 


Description 
"PAG3" EBCDIC record identifier 
EBCDIC last record identifier: 
Not last record 
Last NIPQSR3 record 
TTR of next NIPQSR3 record (if any) 
Slot/Group map of the sequential LPA address 
Space; each entry is three bytes long; the first 
entry is for the lowest address LPA page 
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SLOT QUEUE 


Bytes and 
Displacement Bit Pattern Field Name 
0(0) 1 SQCHPGNO 
1(1) 3 SQSEQSQA 
4 (4) 1 SQSECNO 
5(5) 3 SQSECSQA 
8 (8) uk 
XXXX ween SQHHDEL 
ecee XXXX SQRECNO 
9(9) 3 SQ1CHPGA 
12(C) 1 SQINDX 
13(D) 3 SQLCHPGA 


NIP SYSTEM PARAMETER ENTRY (SPE) 


Description 
Number of channel programs for this queue 


Address of the slot queue for the next sequential 
slot on device 

For a slot sector device, sector number for this 
slot 

Address of the slot queue for the next secondary 
slot on device 


HH Delta 

Record number within a track for this slot 
Address of first channel program on slot queue 
Index used to calculate the address of this slot 
queue 

Address of last channel program on slot queue 


Pointed to by: NVTSPE field in NVT or NIPSPEQ 
Size: 8 bytes 
Initialized Ly: Operator reply processing routines in IEAVNP01 and IEAVNPO3 
Bytes and 

Displacement Bit Pattern Field Name Description 

0(0) 4 NIPSPEQ Address of the next NIPSPE on the queue (0 in last 

SPE) 
4(4) 4 NIPSPEA Address of the operator's reply (the reply prefix, 


184 


REPLY 00 or R OO, is not included in the reply 
text; end of reply test is indicated by a quota- 
tion mark character) 





SECTION 6: DIAGNOSTIC AIDS 


C 


This section contains a listing of the messages and wait state codes, a register usage 
table, and a module/control block cross-reference table. 


Wait State Code 


e Code Issued _ by Description 

X'Q1' IEAIPLOO I/O not operational. 

X*'02' IEAIPLOO I/O could not be started. 

X'Q3' IEAIPLOO I/O could not be started. 

X'Ou' IEAIPLOO CSW not stored. 

X'O5' IEAIPLOO Unit check. 

x'06' IEAIPLOO Program, channel data, channel control, channel chaining, or 
interface control check. 

X*07' IEAVNPO1 No active master console found. 

X'OA' IEAVNPO 3 Catalogs entry for the SYS1.LINKLIB coulc. not be found or suc- 
cessfully retrieved. 

x'Ooc* IEAIPLOO IEANUCOX not edited in scatter format. 

X'OE' IEAIPLOO SYS1.NUCLEUS or IEANUCOX not found. 

X'17' IEAIPLOC Unit check. 

x'18'° IEAIPLO0 Insufficient space to load IEANUCOX. 

Xx'19' IEAIPLOO Unexpected program check. 

X'21' IEAVNIPM I/O error to system console. 

X'30' IEAVNIPO Unexpected ABEND. 

X'31' ITEAVNIPO IPL device has no UCB. 

> ee Fy IEAVN IPO IEAVNIPM not found. . 

IEAVNIPM A required NIP module is not found in SYS1.NUCLEUS. 
x35 fae I/O error during BIDL. 
IEAVNIPM 
ener X' 34° IEAVNIPO DAT feature required but not included. 

X'35' IEAVNIPM Time-of-day clock is inoperative. 

X'36' IEAVNIPM Attempted SQA expansion prior to initialization of paging 
subsysten. 

X'37' IEAVNPO 2 DSCB for SYS1.LOGREC, SYS1.SVCLIB, SYS1.PARMLIB, or SYS1. 


LINKLIB could not be read Eecause the data set does not exist; 
or an I/O error occurred. 


X'38' IEAVNIPO 
IEAVNPO 3 
IEAVNPO4 Insufficient real storage for initialization. 
IEAVNPAY 
x'39° IEAVNPO 2 A required DASD volume cannot be successfully mounted. 
X'3A° IEAVNPOS5 Coldstart process failed: CPEN failed for SYS1.LPALIE, I/0 
error, LPALIB empty, DASD pages unavailable, or storage 
unavailable. 
X'3F' IEAVNIPM System error (indicated by Eits 36-48 in wait state PSW). 
IEAVNPA5 Invalid request code specified via POST. 
X"40' IEAVNIPM Unexpected ABEND. 
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REGISTER USAGE TABLE 


This table lists the entry points for each module, the name of the routine to which 


each module normally exits, and the register ccntents upon entry and exit. 


Beginning 


with the exit from IEAVNIPO, the following registers are part of standard linkage conven- 


tions and have the same contents upon entry to each module. 
ters are noted in the table only where significant. 


ters are irrelevant. 


1 (RPARM) 
2 (RNVT) 

3 (RCVT) 
14 (REXIT) 
15 (RENTRY) 


( IEAVNIPO 


Address of 
Address of 
Address of 
Address of 
Address of 


CVT 


Entry Exit Registers 
IEAIPLOO 0-15 
(not used) 
to xX‘'16Cc' 1 
3 
4 
6 
7 
8 
9 
10 
3 
6 
7 
10 
IEAVNIPM 1 (RPARM) 
2 (CRNVT) 
3 (RCVT) 
15 (RENTRY) 
IEAVNIPM 1 (RPARM) 
ITEAVNIPX 15 (RENTRY) 
NIPLOAD 1 (RPARM) 
Caller 1 (RPARM) 
Via REXIT 
NIPSENSE 1 (RPARM) 
Caller 
via REXIT 
NIPSQEND 
No exit; 
disabled wait 
NIPSWAIT No exit; 
disabled wait 


The contents of these regis- 
The contents of other omitted regis- 


parameter list 
NIP vector table 


next entry point to receive control 
entry point within this module. 


Contents 


Trrelevant 


Address of the IEANUCOx translation table 

Address of the nucleus data set/volume data 
area 

Address of the nucleus CSECT size table 
(SIZTABLE) 

Size of real storage 

Address of the end of the resident nucleus 

Address of the nucleus CSECT address takle 
(ADRTABLE) 

Number of nucleus CSECTs (SIZTABLE entries + 

ADRTABLE entries) 

Device address of the IPL volume 


Address of the IPLDATA parameter area 
Real storage size 

Address of the end of the resident nucleus 
Device address of the IPL volume 


Address of 
Address of 
Address of 
Address of 


the SYS1.NUCLEUS DCB 
the NVT 

the CVT 

IEAVNIPM entry 


Address of the SYS1.NUCLEUS DCB 


Address of IEAVNIPX entry 

Address of the 8-character module name to be 
loaded from SYS1.NUCLEUS 

Address of entry point of loaded module 


Address of the IOB for the failing I/0 
operation 
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Entry 
NIPSVC 


(NIPSVCX) 


NIPTIME 


NIPUCBFN 


NIPWTO 


NI PWTOR 


NIPWTOR2 


IEAVNPO1 


IEAVNPO2 


IEAVNPA2 


IEAVNPB2 


IEAVNPO3 


IEAVNPO4 


IEAVNPA4 
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Type-3, 
Type-4, or 
XCTL routine 


Caller 
via REXIT 


Caller 
Via REXIT 


Caller 
via REXIT 


NI PWTOR2 
Caller 
Via REXIT 


Caller of 
NIPWTOR or 
NI PWTOR2 


IEAVNIPM 


IEAVNIPM 


Caller 
Via REXIT 


Caller 


IEAVNIPM 


IEAVNIPM 


Caller 
Via REXIT 


Registers 
Ore, Gls: “SES ES 
4 


bs) 
14 
15 


0, 1, 4, De 
13, 14, 15 


1 (RPARM) 


1 (RPARM) 


1 (RPARM) 
1 (RPARM) 


1 (RPARM) 


1 (RPARM) 
15 (RENTRY) 
1 


1 (RPARM) 
14 (REXIT) 


1 (RPARM) 


Standard 
Standard 


Standard 
Standard 


1 (RPARM) 
1 
1 (RPARM) 
1 
Standard 
Standard 


Standard 
Standard 


1 (RPARM) 


1 


Contents 

SVC parameter registers 
Address of TCB 

Address of RB 

Address of SVC 3 instruction 


XCTL entry —- address of parameter list 


Unchanged 


Request indication: 


X'00' - TCD clock value 
X'O4' - relative time since IEAVNIPM first 
entered 


Current value of TOD clock or relative time 


EBCDIC unit name or device address 


Address of UCB if found or 0 if not found 


Address of message to be written to ccnsole 


Unchanged 


Address of WTOR parameter list 
Address of NIPWTOR2 entry 
Unchanged 


Positive - address of NIPWTOR parameter list 


Negative (two's complement) address 
buffered reply to be released 


of SQA- 


Return address of caller of NIPWTOR if wait 


Specified or address of caller of 


NIPWTOR2 


Address of the operator's reply (irrelevant 
if called to release SQA reply buffer) 


Unchanged 


Unchanged 


Address of the NIPMOUNT parameter list 
Address of the UCB for the mounted volume, 


or 0 if request canceled 


Address of the parameter list of the data 


set to ke opened 
Unchanged if open is successful, or 


two's 


complement of address if open failed 


Unchanged 


Unchanged 


Address of parameter list indicating func- 


tion to be performed 


Read requests - address of quickstart record 
Other successful requests - unchanged 
Unsuccessful request - two's complement of 


address 





Entry Exit Registers Contents 


IEAVNPO5 Standard 
IEAVNIPM Standard Unchanged 
IEAVNPAS 1 (RPARM) Address of parameter list containing RCVT 
and RNVT values 
IEAVNPO5 Standard Unchanged 
IEAVNP06 Standard 
IEAVNIPM Standard 
IEAVNPO7 Standard 
IEAVNIPM Standard 
IEAVNI PX Standard 
ITEEVIPL 4 Address of SYS1.PARMLIB UCB 


Module/Control Block Cross Refernce 


The following table is a module/control block cross-reference table. The letter M 
means the, module modifies the control block (the module may also refer to the control 
block). The letter R means the module refers to the control block (the module does not 
modify the control block). 


re a ar ea: Cana) Gens ans! Ceara, meiat (neni) Ouine ae Daal Coriieraae Melina Dai ee Gaines: jmnin er zaiaas | 
|Control Block |NIPO |NIPM |NPO1 |NPO2 |NPO3 |NPO4 |NPAY |NPOS |NPA5 |NPO6 |NPO7 |NIPX | 
[--------------- $-----4-----$-----4-----$--- == f === f= fn fn pn fn ta 
| CVT | M | R | R | R | R | M | R | MYM] M | M | DM | 
a Se a Oa es i 
| DEB | M | M | M [| M | | | M | | | Rk | | 

--------------- $-----}-----$-----$---- =f ---- f= fn ff nn ff nt 
[NVT | mM | MftM | M | M | M | MM | mM | OM tl OU YOU Tl Re OY 
--------------- es a es rs Se Si i a 
| PVT | M | M | | | | ue | mM [ M | | | uM | M | 
=== = === === == =f === fanfare n nn pn nnn fn np nn te nn d 
| CVT | M | R | | | | R | | R | | | oR | 
[--------------- $-----4----- $-----4----- $-----$-----4-----$-----4-----f----- == $-----4 
[Master | | | | | | | | | | | | | 
| Scheduler | | | | | | | | | | | | | 
[TCE | M | | | | | | | mM | | | | M | 
p---- === === =f =f nf nnn pennant manning nnnn tenn penn nad 
|Communications | | | | | | | | | | | | | 
|Task TCB | | | | | | | | | | R | | oM | 
ee ee pee een . pe 2 2 ae boo Lona a enon | Loe is ies ia J 
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GLOSSARY 


active page: A page in real storage that 
can be addressed. 


active page queue: A queue of pages in 
real storage that are currently assigned to 


tasks. Pages on this gueue are eligible 
for placement on the available page queue. 


address translation: The process of chang- 
ing the address of an item of data or an 
instruction from its virtual address to its 
real storage address. See also dynamic 
address translation. 


automatic priority group: In VS2, a group 
of tasks at a single priority level that 


are dispatched according to a special 
algorithm that attempts to provide oftimum 
use of CPU and I/O resources by these 
tasks. See also dynamic dispatching. 


available page frame count: In VS2, a 
count of page frames that are ready for 


reassignment. 


available page queue: A queue of the pages 
whose real storage is currently available 


for allocation to any task. See also 
active page queue, hold page queue. 


basic control (BC) modes A mode in which 
the features of a System/360 computing sys- 
tem and additional System/370 features, 
such as new machine instructions, are 
operational on a System/370 computing sys- 
tem. See also extended control (EC) mode. 


DAT: Dynamic address translation. 


demand paging: Transfer of a page from 
external page storage to real storage at 
the time it is needed for execution. 


device number: In VS2, a part of an 
external page address that refers to a par- 
ticular paging device; together with a 
group number and a slot number, it identi- 
fies the location of a page in external 
page storage. 


disabled page fault: A page fault that 
occurs when I/O and external interruptions 


are disallowed by the CPU. 


dynamic address translation (DAT): (1) The 
change of a virtual storage address to a 


real storage address during execution of an 
instruction. See also address translation. 
(2) A hardware feature that performs the 
translation. 
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dynamic area: The portion of virtual 
Storage that is divided into regions or 
fartitions that are assigned to jok steps 
and system tasks. See also pageable dynam- 
ic area, nonpageable dynamic area. Con- 
trast with nondynamic area. 


dynamic dispatching: In VS2, a facility 
that assigns priorities to tasks within an 


automatic priority group to provide optimum 
use of CPU and I/O resources. 


FC mcde: Extended control mode. 


enakled page fault: A page fault that 
cccurs when I/C and external interruptions 


are allowed by the CPU. 


extended control (EC) mode: A mode in 
which all the features of a System/370 com- 
puting system, including dynamic address 
translation, are operaticnal. See also 
kasic control (BC) mode. 


external page address: An address that 
identifies the location of a page in a page 


data set. In VS2, the address consists of 
a relative device number, a relative group 
number, and a relative slot number. 


external page storage: The portion of 
auxiliary storage that is used to contain 


pages. 


external page storage management: A set of 
routines in the paging supervisor that con- 


trol external page storage. 


external page takle (XPT): In VS2, an 
extension of a page table that identifies 


the location on external page storage of 
each page in that page table. 


fixed: In OS/VS, not capable of being 
paged out. 


fixed BLLDL table: A BLDL table that the 
user has specified to be fixed in the lower 
frortion of real storage. 


fixed link pack area: In VS2, an extension 
of the link pack area that occupies fixed 


pages in the lower portion of real storage. 


fixed page: A page in real storage that is 
not to ke paged out. 


group number: In VS2, a part of an extern- 
al page address that refers to a slot 
group; together with a device numbe~ and a 
Slot numker, it identifies the location of 
a page in external page storage. 
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invalid page: A page that cannot be 
directly addressed by the dynamic address 
translation feature of the central process- 
ing unit. 


link pack area (LPA): In VS2, an area of 
virtual storage containing selected reent- 


erable and serially reusable routines that 
are loaded at IPL time and can be used con- 
currently by all tasks in the systen. 


link pack area directory: In VS2, a direc- 
tory that contains an entry for each entry 


point in link pack area modules. 


link pack area library: In VS2, a rarti- 
tioned data set that contains the modules 


specified to be in the link pack area. 


link pack area queue: In VS2, a queue that 
contains a contents directory entry for 


each link pack area module currently in 
use, for each module in the link pack up- 
date area, and for each module in the fixed 
link pack area. 


link pack update area: In VS2, an area in 
virtual storage containing modules that are 


additions to or replacements for link pack 
area modules for the current IPL. 


local system queue area (LSQA): In VS2, 


one Or more segments associated with each 
virtual storage region that contains job- 
related system control blocks. 


LPA: Link pack area. 
ISQA: Local system queue area. 
Memory: See real storage, virtual storage. 


nondynamic areas The area of virtual 
Storage occupied by the resident portion of 
the control program (the nucleus and the 
link pack area). Contrast with dynamic 
area. 


nonpageable dynamic area: An area of vir- 
tual storage whose virtual addresses are 


identical to real addresses; it is used for 
programs or parts of programs that are not 
to be paged during execution. Synonymous 
with V=R dynamic area. 


nonpageable region: In VS2, a subdivision 
of the nonpageable dynamic area that is 
allocated to a job step or system task that 
is not to be paged during execution. Ina 
nonpageable region, each virtual address is 
identical to its real address. Synonymous 
with V=R region. 


OS/VS: A compatible extension of the 
System/360 Operating System that supports 
relocation hardware and the extended con- 
trol facilities of System/370. 





page: (1) A fixed-length block of instruc- 
tions, data, or both, that can be trans- 
ferred between real storage and external 
gage storage. (2) To transfer instruc- 
tions, data, or both between real storage 
and external page storage. 


Kageable dynamic area: An area of virtual 
storage whose addresses are not identical 


to real addresses; it is used for programs 
that can be paged during execution. 
Synonymous with V=V dynamic area. 


pageable region: In VS2, a subdivision of 
the pageakle dynamic area that is allocated 
to a jor step or system task that can be 
paged during execution. Synonymous with 
V=V region. 


page control block (PCB): A control block 
that indicates the status of a paging 
request. 


gage data set: A data set in external page 
storage, in which pages are stored. 


page fault: A program interruption that 
cccurs when a page that is marked “not in 
real storage" is referred to by an active 
rage. Synonymous with fage translation 
exception. 


page fixing: Marking a page as nongageakle 
so that it remains in real storage. 


page frame: A -Elock of real storage that 
can contain a cage. Synonymous with frame. 
See also storage DbDlock. 


page frame table: In VS2, a table that 
contains an entry for each frame. Each 
frame table entry describes how the frame 
is being used. 


page migration: In VS2, the transfer of 
rages from a primary paging device to a 
secondary paging device to make more space 
availakle on the primary paging device. 


Eage-in: The process of transferring a 
page from external page storage to real 
storage. 


page numker: The part of a virtual storage 
address needed to refer to a page. See 
also frame number. 


page-out: The process of transferring a 
page from real storage to external page 
storage. 


page reclamation: The process of making 
addressakle the contents of a page in real 


storage that has been marked invalid. Page 
reclamation can occur after a page fault or 
after a request to fix or load a page. 


Glossary 193 


page table (PGT): A table that indicates 
whether a page is in real storage and 
correlates virtual addresses with real 
Storage addresses. 


page translation exception: A program 
interruption that occurs when a virtual 


address cannot be translated by the hard- 
ware because the invalid bit in the page 
table entry for that address is set. 
Synonymous with page fault, program inter- 
ruption code 17. 


page wait: A condition in which the active 
request block for a task is placed ina 
wait state while a requested page is 
located in real storage or is Erought into 
real storage. 


paging: The process of transferring pages 
between real storage and external page 
storage. 


paging device: A direct access storage 
device on which pages (and possibly other 
data) are stored. 


paging supervisor: A part of the supervi- 
sor that allocates and releases real 


storage space (page frames) for pages, and 
initiates page-in and page-out operations. 


PFT: Page frame table. 


PGT: Page table. 


Erimary paging device: In VS2, an auxi- 
liary storage device that is used in pre- 


ference to secondary paging devices for 
paging operations. Portions of a primary 
paging device can be used for purposes 
other than paging operations. 


quick cell: In VS2, a reserved space in 
the system queue area or a local system 
queue area that can be used to reduce the 
time required to allocate space for a con- 
trol block. 


quickstart pages: Pages ina single page 
data set that contain the link pack area 
modules and link pack area directory that 
are to be made available to the system dur- 
ing a quickstart. 


quickstart records: One or more records, 
located at the beginning of a formatted 
page data set, that contain information 
that makes it possible to use the data set 
over successive IPLs. The quickstart rec- 
ords identify all usable pages in the data 
set and, for a page data set containing 
quickstart pages, identify the location of 
those pages in the data set. 

real_ address: The address of a location in 
real storage. 
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real storage: The storage of a System/370 
computing system from which the central 
processing unit can directly obtain 
instructions and data, and to which it can 
directly return results. 


reference Fit: A bit associated with a 
gage in real storage; the reference Lit is 
turned "ON" by hardware whenever the aSSo- 
ciated page in real storage is referred to 
(read or stored into). In VS2, there is a 
reference bit in each of two storage keys 
associated with each page frame. 

relocate hardware: See dynamic address 
translation. 


Secondary paging device: In VS2, an auxi- 
liary storage device that is not used for 


fraging operations until the availakle space 
on primary paging devices falls belowa 
specified minimum. Portions of a secondary 
paging device can be used for purpcses 
other than paging operations. 


segment: A continuous 64K area of virtual 
storage, which is allocated to a job or 
system task. 


segment table (SGT): A table used in 
dynamic address translation to control user 


access to virtual storage segments. Each 
entry indicates the length, location, and 
availability of a corresponding page takle. 


segment table entry (STE): An entry in the 
segment table that indicates the length, 


location, and availability of a correspord- 
ing rage table. 


Slot: In VS2, a continuous area on a pag- 
ing device in which a page can be stored. 


Slot group: In VS2, a set of slots on one 
or mcre tracks within a cylinder on a pag- 
ing device. 


slot number: In VS2, a part of an external 
page address that refers to a slot; togeth- 
er with a device number and a grouf numer, 
it identifies the location of a page in 
external page storage. 


SQA: System queue area. 
swapping: In VS2 with TSO, a paging tech- 


nique that writes the active pages of a job 
to external page storage and reads pages of 
another job from external page storage into 
real storage. 


system queue area (SQA): An area of virtu- 


al storage reserved for system-related con- 
trol biocks. 





thrashing: A condition in which the system 
can do little useful work recause of exces- 
Sive paging. 


virtual address: An address that refers to 
virtual storage and must, therefore, be 
translated into a real storage address when 
it is used. 


virtual equals real (V=R) storage: An area 
of virtual storage that has the same range 


of addresses as real storage and is used 
for a program or part of a program that 
cannot be paged during execution. 


V=R_ dynamicearea: Same as nonpageable 
dynamic area. 


V=R_ partition: Same as nonpageable 
partition. 


V=R_ region: Same as nonpageable region. 


virtual storage: Addressable space that 
appears to the user as real storage, from 
which instructions and data are mapped into 
real Storage locations. The size of virtu- 
al storage is limited by the addressing 
scheme of the computing system and by the 
amount of auxiliary storage available, 
rather than ky the actual number of real 
storage locations. 


virtual storage region: In VS2, a subdivi- 
sion of the dynamic area that is allocated 


(in segment-size blocks) to a job step ora 
system task. 


V=V_dynamic area: Same as pageable dynamic 
area. 


V=V_region: Same as pageable region. 
XPT: External page table. 


XPTE: External page table entry. 
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IEAVNPO6, description 27 

IEAVNP06, diagram 122 

IEAVNPO7, description 28 

IEAVNPO7, diagram 134 

IEAPMNIP, NIP macro instruction 6 
Initialize page data sets 6 
Initializing for Quickstart records 22 
Initial paging area 7 

Initial Program Loader, location 9 
Initial system queue area definition 16 
Introduction to IPL/NIP frocessing 1 
IPIDATA 176 

IPL/NIP processing (high level diagram) 2 


Linkage to service subroutines 6 

Link Pack area in quickstart/coldstart 6 
LOAD button 12,1 

Loading of NIP modules 9 

LOAD light 12 

Load unit address switches 12 

Iocation of IPL records in real storage 13 
LPA in quickstart/coldstart 6 

LPA page data set information 6 

LSQACEL parameter 29 


Main functions of IPL and NIP 1 

MANUAL light 12 

Maxinum virtual address 15 

MCH 27 

Messages 186 

Methcd of operation diagrams, 
introduction 9 

Module/control block cross reference 
table 191 

MPA parameter 29 

Multiple control registers initialized by 
IEFAVNIPO 17 


NIPABEND, description 19 
NIPLOAD, description 17 

NIPLCAD, diagram 44 

NIP macro instruction, IEAPMNIP 6 
NIP module functions 1 

NIP module loading 9 

NIPMOUNT, description 20 
NIPMCUNT, diagram 58 

NIPMOUNT, flowchart 171 

NIPMOUNT parameter list 176 
NIPOPEN, description 20 

NIPOPEN, diagram 60 

NIP PARMAREA 180 

NIPQSR1, quickstart record 6,183 
NIPQSR2, quickstart record 6,183 








NIPQSR3, quickstart record 


NIPSENSE, 
NIPSQEND, 


NIPTIME, description 18 
NIPTIME, diagram 50 
NIPUCBFN, description 18 
NIPUCBFN, diagram 48 

NIP vector takle (NVT) 
NIPSWAIT, description 19 
NIPWTO message header 177 
NIPWTO and NIPWTOR, 
NIPWTOR2, description 19 
NPAYBCCV, description 24 
NPA4YBCCV, diagram 88 
NPAYBDIR, description 26 
NPAYCCST, description 25 
NPAU4CCST, diagram 94 
NPAYFREE, description 24 
NPAYFREE, diagram 84 
NPAYGBUF, description 24 
NPAYGBUF, diagram 82 
NPAYVINTC, deScription 24 
NPAYINTC, diagram 90 
NPAVINTF, deScription 24 
NPAUINTF, diagram 86 
NPAYLOAD, description 24 
NPAYLOAD, diagram 92 
NPA4READ, description 24 
NPAYREAD, diagram 80 
NPAYRSTB, description 24 
NPAYRSTB, diagram 86 
NPAWWRIT, description 24 
NPAWWRIT, diagram 80 
NPASALIS, description 26 
NPA5BLDL, description 26 
NPASBLDL, diagram 114 
NPASCLIN, deScription 26 
NPASCLPA, deScription 26 
NPASCLPA, diagram 116 
NPASLGRP, description 27 
NPASLGRP, diagram 120 
NPASLIND, deScription 26 
NPA5SMLPA, description 26 
NPA5MLPA, diagram 112 
NPASTERM, description 26 
NPA5STERM, diagram 118 
NPXAPG, description 
NPXAPG, diagram 150 
NPXFAREA, description 29 
NPXFBUF, description 29 
NPXFJPQ, description 29 


description 
description 


NPXFJPQ, diagram 160 


17 


19 
NIPSVC and NIPSVCX, description 
NIPSVC and NIPSVCX, diagram 


8,178 


description 


NPXREAL, description 
NPXRTRAP, description 
NPXTMSL, description 
NPXTMSL, diagram 152 
NPLINIT and NP1iTCOMM, 
NP1TCOMM and NP1INIT, 
NP3LCAT, description 
NP3LCAT, diagram 72 
NP3LKLIB, description 
NP3OPSP, description 
NP3OFSP, diagram 62 
NP3PBASE, description 
NP3PBASE, diagram 64 
NP3PMLIB, description 
NP3PLMRG, description 
NP3PTAB, description 
NP3PTAB, diagram 70 
NP3SYSP, description 
NP3SYSP, diagram 68 
NP4APFT and NP4&BPFT, 
NP4YBCPQ, description 
NP4BSQA, description 
NP4IPVT, description 
NP4YPDSEL, descrirtion 
NP4YPDSEL, diagram 76 
NP4RQSR2, description 
NPSBIDLP, description 
NP5SBLDLP, diagram 10 
NP5SCSLPA, descrirftion 
NP5CSLPA, diagram 10 
NPSLFLIB, description 
NP5LPLIB, diagram 10 
NP5MLPA, description 
NP5MILPA, diagram 106 
NP5QSLPA, description 
NP5QSLPA, diagram 98 
NP5VTCB, description 
NP5VTCB, diagram 102 
NP6DMP, description 
NP6DMP, diagram 126 
NP6DSS, description 
NP6DSS, diagram 124 
NP6EXCP, description 
NP6MOVE, description 
NP6RMS, description 
NP6RMS, diagram 130 
NP6TRA, description 
NP6TRA, diagram 132 
NP7JEPFP, description 
NP7VEPFP, diagram 144 


29 

30 

29 

diagram 54 
diagram 54 
22 


22 
20 


20 

21 

21 
21 
21 


description 23 


8 
0 


4 
25 


25 

25 
27 
27 

27 

27 
27 
27 


28 


NPVHCCPY, description 28 


NP7HDCPY, diagram 13 
NP7LPAFN, description 
NP7LPAFN, diagram 14 


NPXMCSPO, description 30 
NPXMCSPO, diagram 166 
NPXMLSQA, description 30 
NPXMLSQA, diagram 162 
NPXMPA, description 29 
NPXMPA, diagram 156 
NPXMPA1, description 29 
NPXMPA1, diagram 158 
NPXQOCELL, description 29 
NPXQCELL, diagram 154 
NPXPFTAQ, description 30 
NPXPFTAQ, diagram 164 
NPXRDAT, deScription 30 
NPXRDAT, diagram 168 


NP7OTEST, 


description 


NP7PAL, description 
NP7PAL, diagram 142 
NP7JPDCM, description 


NP7PCCM, 
Nucleus 


diagram 138 


Nucleus kuffer 7 
Nucleus Initialization Program modules 14 
Nucleus loading ky IEAIPLOO 13 

Nucleus specification by operator 13 

NVT initialization 1 
NVT (NIP vector table) 8 


6 

28 
0 

28 
28 


28 


mM 


Index 197 


Operator communication initiation 19 
Operator interface during IPL 13 
Operator limitation of real storage 
Size 13 

Operator specification of nucleus 13 
OPERTAB building 21 

OPERTAB into PLIBTAB merging 21 


Page data set formatting 6 

Page device information table 179 
Page device table 180 

PAGE parameter processing 22 

Page table initialization 15 

Paging device 6 

Paging initialization 15 

Paging supervision control block 
initialization 22 

Paging table initialization 1 

PAL system parameter 28 

Parameter table entry 182 

Parameter address table 181 

PARMAREA_ 8 

PARMAREA building 21 

PFT definition 14 

PLIBTAB building 21 

Processing expected program checks 13 
Program checks, processing expected 13 
PVT definition 14 


Quickstart/coldstart process 6 
Quickstart Record, NIPQSR1 6 
Quickstart records 8 


RAS initialization 27 
REAL parameter 29 
Real storage after page device 
initialization 23 
Real storage areas during NIP processing 7 
Real storage at completion of IEAVNIPO 17 
Real storage before and after IPL 
relocation 13 
Real storage, clearing by IEAIPLOO 13 
Real storage definition 15 
Real storage initialization 1 
Real storage size 1 
Real storage size, limitation Ly 
operator 13 
Real storage, storage keys 14 
Reformatting page data sets for restart 6 
Registers, clearing by IEAIPLOO 12 
Re-IPL, quickstart records in 6 


198 


Reliability and serviceability 
initialization 27 
Residency characteristics of NIP 

modules 14 

Resident nucleus, creation and loading 1 
RMS 27 


Sample diagram 10 

Segment takle initialization 15 

Service subroutines, linkage to 6 

Slot/group map of LPA address space 6 

Slot queue 184 

SQACEL farameter 29 

SQA parameter processing 22 

Storage keys, real storage 14 

Storage keys, setting by IEAIPLOO 13 
Subroutines in method of operation diagrams 12 
SVCDUMP 27 

System console initialization 19 

System data set access l 

System parameter area creation 21 

System parameter entry 184 

System parameter table initialization 20 
System queue area /7 

System restart, quickstart/coldstart 6 

System segment and page tables 16 

System trace taktle definition 14 

SYS1.DSSVM 7 
SYS1.DUMP 7 
SYS1.LINKLIB 7 
SYS1.LOGREC 7 
SYS1.LPALIB 6, 
SYS1.NUCLEUS 7 
SYS1.PAGE /7 
SYS1.PARMLIB 7 
SYS1.SVCLIB 7 


7 


IMSL parameter 29 
TRACE system parameter 27 
TSOAUX parameter 29 


Using method of operation diagrams 9 


Virtual addressing 15 
Virtual storage access 1 
Virtual storage segment and block size 15 


Wait state codes 185 


ww 


‘ 








SY27-7243-0 


SM 


International Business Machines Corporation 

Data Processing Division 

1133 Westchester Avenue, White Plains, New York 10604 
(U.S.A. only) 


IBM World Trade Corporation 
821 United Nations Piaza, New York, New York 10017 
(international) 


SA/SO 


dIN/TdI 


“-w°S'oO UT peqUtTag 


Lae VEL LGAs 








